brightbean-studio: Open Source Scheduling & Event Management

brightbean-studio

“Open-source, self-hostable social media management platform. Schedule, publish, and manage content across 10+ platforms from a single dashboard. Free alternativ”

star history · 3d tracked

+12

stars★ 2.3K forks⑂ 501 licenseAGPL-3.0 written inPython categoryBusiness Software typeScheduling & Event Management last push7 hours ago

Open-source, self-hostable social media management platform. Schedule, publish, and manage content across 10+ platforms from a single dashboard. Free alternative to Buffer, Sendible, and SocialPilot.

maintainer? embed the star badge

get the markdown →

What is brightbean-studio?

What it is

BrightBean Studio is an open-source, self-hostable social media management platform for creators, agencies, and small and medium-sized businesses. It is built in Python and Django, uses HTMX, and can be deployed with Docker. The project lives in the Python and Django open-source web application ecosystem.

It solves the need to plan, compose, schedule, approve, publish, and monitor content across Facebook, Instagram, LinkedIn, TikTok, YouTube, Pinterest, Threads, Bluesky, Google Business Profile, Mastodon, and DEV.to from one dashboard. It uses direct first-party APIs with user-owned developer credentials, avoiding per-seat, per-channel, or per-workspace SaaS limits.

Key capabilities

Multi-workspace management supports unlimited organizations, workspaces, members, custom roles, invitations, and a Client role for external collaborators.
The composer includes a rich editor, per-platform caption and media overrides, version history, reusable templates, tags, categories, and a Kanban idea board.
Scheduling provides a visual calendar, recurring weekly posting slots per account, and named queues that auto-assign posts to the next available slot.
Publishing connects directly to first-party APIs, retries failed posts, tracks per-account rate limits, and keeps a 90-day publish audit log.
The unified inbox collects comments, mentions, direct messages, and reviews, while approval workflows and a 30-day magic-link client portal handle review and sign-off.
Analytics reports per-post and channel-level performance from native APIs, with KPI cards, 7/30/90-day trend charts, and a sortable all-posts table.
Media libraries are scoped to organizations and workspaces, with nested folders, platform-optimized variants, alt text, and Unsplash search in the composer.

Who uses it and how

Agencies manage many client accounts under one roof by separating organizations, workspaces, internal roles, and external Client roles.
Social media managers plan ideas on a Kanban board, compose posts with per-platform overrides, and place them in recurring calendar slots or named queues.
Reviewers approve content through internal and client workflows, while community managers monitor comments, mentions, direct messages, and reviews in a unified inbox.
Operators use the free hosted version, deploy on a VPS with Docker, or run the application locally.

Getting started

Users can use the free hosted version at brightbean.xyz/studio, deploy with one-click buttons on Heroku, Render, or Railway, run the application on a VPS with Docker, or run it locally.

When to use it — and when not to

BrightBean Studio is useful when teams want an open-source alternative to Buffer, Sendible, SocialPilot, or ContentStudio and need unlimited workspaces without per-seat, per-channel, or per-workspace limits. Self-hosting requires teams to operate the deployment, manage developer credentials for each first-party API, and configure email notifications, while two-factor authentication with TOTP remains on the roadmap.

project readme (upstream, from github) — read inline

Open-source social media management for creators, agencies, and SMBs.

About BrightBean Studio

BrightBean Studio is an open-source, self-hostable social media management platform built for creators, agencies and SMBs. It does what Sendible, SocialPilot, or ContentStudio do, but free and without per-seat, per-channel, or per-workspace limits. Plan, compose, schedule, approve, publish, and monitor content across Facebook, Instagram, LinkedIn, TikTok, YouTube, Pinterest, Threads, Bluesky, Google Business Profile, Mastodon, and DEV.to from a single multi-workspace dashboard.

It's for people managing many client accounts under one roof who'd rather own their social stack than pay $100–300/month to a SaaS vendor. Every feature is available to every user. No paid tier, no feature gate, no upsell.

A free hosted version is available at brightbean.xyz/studio. You can also deploy it yourself with a one-click button on Heroku, Render, or Railway, run it on your own VPS via Docker, or run it locally. All platform integrations talk directly to the official first-party APIs using your own developer credentials, so there's no aggregator middleman, no vendor lock-in, and no third party sitting between you and your data.

Features


Multi-workspace & teams	Unlimited orgs → workspaces → members. Granular RBAC with custom roles, invitations, and a separate Client role for external collaborators.
Content composer	Rich editor with per-platform caption/media overrides, version history, reusable templates, content categories & tags, a Kanban idea board.
Calendar & scheduling	Visual calendar with recurring weekly posting slots per account and named queues that auto-assign posts to the next available slot.
Publishing engine	Direct first-party API integrations (no aggregator), automatic retries, per-account rate-limit tracking, and a 90-day publish audit log.
Approval workflows	Configurable stages (none / optional / internal / internal + client), threaded internal & external comments, reminders, and a full audit trail.
Unified social inbox	Comments, mentions, DMs, and reviews from every connected platform in one place, with sentiment analysis, assignments, threaded replies, and historical backfill.
Analytics	Per-post and channel-level performance from every connected platform's native API, with KPI cards, 7/30/90-day trend charts, and a sortable all-posts table for views, engagement, follower growth, reach, and watch time.
Media library	Org- and workspace-scoped libraries with nested folders, auto-generated platform-optimized variants, alt text, and built-in Unsplash stock-photo search in the composer.
Client portal	Passwordless 30-day magic-link access so clients can approve or reject posts without creating an account.
Notifications	In-app, email, and webhook delivery with per-user preferences for every event type.
Security & ops	Encrypted token & credential storage, Google SSO, Sentry support, and a 14-day reversible org-deletion grace period. 2FA (TOTP) is on the roadmap.
White-label friendly	Per-workspace branding (logo, colors) and workspace defaults for hashtags, first comments, and posting templates.

A quick look

_{Visual calendar - drag-and-drop scheduling with recurring slots and queues.}
_{Post editor - composer with per-platform overrides and previews.}	_{Idea board - Kanban workflow to keep track of all your post ideas.}
_{Connect anything - 10+ first-party integrations, no aggregator.}	_{Performance analytics - per-post and channel-level metrics with KPI cards and trend charts.}

Supported Platforms

Platform	Publish	Comments	DMs	Insights
Facebook	✓	✓	✓	✓
Instagram	✓	✓	✓	✓
Instagram (Direct)	✓	✓	✓	✓
LinkedIn (Personal)	✓	✓	—	✓
LinkedIn (Company)	✓	✓	—	✓
TikTok	✓	—	—	✓
YouTube	✓	✓	—	✓
Pinterest	✓	—	—	✓
Threads	✓	✓	—	✓
Bluesky	✓	✓	—	—
Google Business Profile	✓	—	—	✓
Mastodon	✓	✓	—	—
DEV.to	✓	—	—	—

Hosted Version

A free hosted version of Brightbean Studio is available at brightbean.xyz/studio. It runs the same codebase as this repository, with no setup or maintenance required.

If you'd rather self-host, choose one of the options below.

One-Click Deploy

Heroku	Render	Railway

After deploying, set these environment variables in your platform's dashboard:

Variable	Required	Description
`DJANGO_SETTINGS_MODULE`	Auto-set	`config.settings.production`. Set if deployment config has not placed it.
`SECRET_KEY`	Auto-generated	Django secret key. Set automatically by the deploy button.
`ENCRYPTION_KEY_SALT`	Auto-generated	Encryption salt. Set automatically by the deploy button.
`DATABASE_URL`	Auto-provisioned	PostgreSQL connection string. Set automatically.
`ALLOWED_HOSTS`	Yes	Your app's domain, e.g. `your-app.herokuapp.com`
`APP_URL`	Yes	Full public URL, e.g. `https://your-app.herokuapp.com`
`STORAGE_BACKEND`	No	Set to `s3` for S3/R2 storage. Default: `local`. Heroku, Render, and Railway have ephemeral filesystems, so uploaded files are lost on redeploy without S3.
`S3_ENDPOINT_URL`	If using S3	S3-compatible endpoint URL
`S3_ACCESS_KEY_ID`	If using S3	S3 access key
`S3_SECRET_ACCESS_KEY`	If using S3	S3 secret key
`S3_BUCKET_NAME`	If using S3	S3 bucket name
`EMAIL_HOST`	No	SMTP server fo

Frequently asked questions

Is brightbean-studio free to use?

brightbean-studio is open source under the AGPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does brightbean-studio do?

Open-source, self-hostable social media management platform. Schedule, publish, and manage content across 10+ platforms from a single dashboard. Free alternativ

What is brightbean-studio written in?

brightbean-studio is primarily written in Python. Its source is publicly available at https://github.com/brightbeanxyz/brightbean-studio, and it has 2,341 GitHub stars.