BrightBean Chat
brightbeanxyz/brightbean-chatReviewed by AI
Checked by RepoPicks Radar on
What is BrightBean Chat?
BrightBean Chat is a chat-marketing tool you host yourself. You draw a flow in a visual builder (keyword replies, comment-to-DM, delays, conditions, drip sequences, broadcasts) and run it on Telegram, Instagram, Messenger, WhatsApp, SMS and email, with a shared inbox where a person can take over a conversation. Installing it means Docker, PostgreSQL and a public web address, plus a developer app of your own at Meta for the Instagram, Messenger and WhatsApp channels. The code is AGPL-3.0; the authors also run a hosted version.
BrightBean Chat is free and open source (AGPL-3.0) and can replace ManyChat, Chatfuel, and SendPulse.
How easy is it to install BrightBean Chat?
B · installer plus one simple step · Web
- Windows D
- macOS D
- Linux D
- Web B
The easiest route is the authors' hosted version at brightbean.xyz/chat: you sign up and connect a channel, with nothing to install, so web is a B. Self-hosting is terminal work on all three systems and there is no release to download: you install Docker, clone the repository and run `docker compose up` for a local try, or copy `deploy/env.prod.example`, generate secrets with `make prod-secrets` and start a five-service production stack (PostgreSQL, migration, Gunicorn, a worker and Caddy) on a server with a public domain name.
BrightBean Chat on GitHub
- Stars
- 86on Nov 10, 2026
- Downloads
- —all releases
- Growth
- +4stars in 6 days
Stars over time
Facts
- Runs on
- Windows, macOS, Linux, Web
- You need to install
- Docker
- To build from source
- Python, Node.js, Docker
- Disk space
- 200 MB–800 MB · estimate
- Accounts or keys
- A token for at least one channel — a Telegram bot token from BotFather is the quickest, Meta developer app (client id, secret and verify token) for Instagram, Messenger and WhatsApp, Twilio (account SID and auth token) for the SMS channel, SMTP, Resend or Amazon SES for the email channel and for the sign-up and password e-mails, Google sign-in (GOOGLE_AUTH_CLIENT_ID and GOOGLE_AUTH_CLIENT_SECRET), optional login button
- Cost
- Free · The code is AGPL-3.0 with, in the README's words, "Unlimited contacts, every feature". The authors' hosted version at brightbean.xyz/chat is described as "free for your first 25 contacts a month". The channels can still cost money at their providers: a Twilio number for SMS, an email provider, and a WhatsApp number metered by Meta.
- License
- AGPL-3.0 (Copyleft)
- Last change on GitHub
- Oct 21, 2026
BrightBean Chat risk signals (5)
- Attentionmeta channels need app review first
README, "What Meta has to approve": a new app has Standard Access and "reaches only accounts whose users hold a role on the app"; using it for someone else's account means App Review per permission "with a screencast showing each one used end to end" plus Business Verification, and "Budget weeks rather than days, and expect at least one rejection". Instagram also needs the account added as an Instagram Tester. Telegram, SMS and email have no such step.
AI review
- Attentionyou hold other people s private messages
The product stores contacts, threaded conversations, custom fields and uploaded media in your own PostgreSQL, and the platform credentials encrypted with the ENCRYPTION_KEY_SALT you generate. docker-compose.prod.yml notes "Postgres holds contacts and the encrypted platform credentials". Backups, the loss of that salt, and the legal duties for that data are all on whoever runs the server.
AI review
- Infono releases and upgrades are rebuilds
The repository was created on 2026-08-20, has 0 GitHub releases and 28 open issues. docker-compose.prod.yml states that "no workflow in this repository pushes an image anywhere" and that "The upgrade path in docs/self-hosting.md is therefore git-pull-and-build", so there is no version number to pin or image to pull.
AI review
- Infobulk messaging is regulated
The README's own channel table lists the rules the tool has to respect: a 24-hour messaging window on Instagram, Messenger and WhatsApp, approved templates outside it, STOP/HELP/START handling and A2P 10DLC registration for US SMS numbers, and SPF/DKIM/DMARC records because "Gmail and Yahoo reject bulk mail from domains without them".
AI review
- Infopayment variable in the environment reference
The checks found STRIPE_WEBHOOK_SECRET (and TICK_TOKEN) among the variables the application understands, while the README says the self-hosted product has "no payment provider to sign up for". The repository is also what the authors' paid hosted version runs, which is the likeliest reason it is there; the variable is not needed to self-host.
AI review
Evidence is shown in its original language.
What Radar could not check about BrightBean Chat
- Whether the hosted version at brightbean.xyz/chat really runs this same code, and what its paid plans cost beyond 25 contacts a month
- Whether the security behaviour the README promises (tenant isolation, SSRF guard, encrypted credentials, webhook signature checks) holds in practice, which would need an audit
- Whether each channel works end to end, which can only be seen with real Meta, Twilio and e-mail accounts
- How the stack behaves on the 1 vCPU / 1 GB host the documentation names as workable, and how much disk the database and media grow to
- Whether a brand-new project three months old keeps being maintained