brightbean-studio  by brightbeanxyz

Social media management platform for creators and agencies

Created 2 months ago
1,811 stars

Top 23.3% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

Summary

BrightBean Studio is an open-source, self-hostable social media management platform designed as a free alternative to commercial SaaS solutions like Buffer and Sendible. It addresses the need for centralized content scheduling, publishing, and monitoring across over 10 social media platforms for creators, agencies, and SMBs. The primary benefit is significant cost savings and full data ownership, eliminating per-seat, per-channel, or per-workspace limitations.

How It Works

The platform is built on a Django backend, leveraging HTMX and Alpine.js for a dynamic frontend experience without a full JavaScript framework. It emphasizes direct, first-party API integrations for all supported platforms, avoiding third-party aggregators to ensure data privacy and reduce vendor lock-in. Key architectural components include a multi-workspace dashboard, a rich content composer with version history, a visual calendar with recurring slots and queues, configurable approval workflows, a unified social inbox with sentiment analysis, and detailed analytics pulled directly from platform APIs. Background tasks, such as post publishing and notifications, are managed by django-background-tasks, eliminating the need for Redis.

Quick Start & Requirements

  • Installation: Docker Compose is recommended for local development and production. A local development setup without Docker requires Python 3.12+, Node.js 20+, and uses SQLite. One-click deployment options are available for Heroku, Render, and Railway.
  • Prerequisites: PostgreSQL is recommended for production; SQLite is suitable for local development. For production deployments on platforms with ephemeral filesystems (Heroku, Render, Railway), S3-compatible storage is required.
  • Deployment: Production deployment via Docker Compose includes containers for the app (Gunicorn), worker, PostgreSQL, and Caddy (for auto-HTTPS).
  • Links: Hosted version: brightbean.xyz/studio. GitHub: https://github.com/brightbeanxyz/brightbean-studio.

Highlighted Details

  • Supports 10+ platforms including Facebook, Instagram, LinkedIn, TikTok, YouTube, Pinterest, Threads, Bluesky, Google Business Profile, and Mastodon.
  • Features unlimited workspaces, members, and granular Role-Based Access Control (RBAC).
  • Includes a client portal with passwordless magic-link access for post approvals.
  • Offers a REST API and MCP (Model Context Protocol) server for agent and script integration.

Maintenance & Community

The provided README does not contain specific details regarding notable contributors, sponsorships, community channels (like Discord/Slack), or a public roadmap.

Licensing & Compatibility

The project is licensed under AGPL-3.0. This strong copyleft license requires any derivative works or modifications distributed to others to also be made available under the AGPL-3.0 license. Commercial use or integration into closed-source applications requires careful legal review due to the copyleft nature of the license.

Limitations & Caveats

The AGPL-3.0 license may pose compatibility challenges for certain commercial or closed-source integration scenarios. Production deployments on Render require a paid tier. Some platform integrations, like LinkedIn personal accounts via the basic OAuth flow, have limitations such as ~60-day token expiry and lack of inbox access.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
18
Issues (30d)
7
Star History
150 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.