## ✨ Features
- **Omnichannel:** WhatsApp, Facebook, Instagram, Threads, TikTok, Telegram, Zalo, Email, API, and Webchat
- **Visual Flow Builder:** Drag-and-drop chatbot builder with 15+ node types
- **AI Agents:** OpenAI, Claude, Gemini, DeepSeek, OpenRouter, NVIDIA NIM, and Local LLMs
- **Live Chat Inbox:** Real-time inbox with human takeover and conversation assignment
- **Contact CRM:** Manage contacts with tags, custom fields, and segmentation
- **Broadcasting:** Send targeted messages to specific contact segments
- **Sequences:** Automate drip campaigns with scheduled messages and auto-enrollment
- **Team Management:** Invite team members, assign roles, and manage permissions
- **Rich Messaging:** Media, files, buttons, quick replies, catalogs, locations, and carousel cards
- **Comment-to-DM:** Automatically message users who comment with specific keywords
- **Comment Automation:** Auto-reply, like, and hide comments on Messenger, Instagram, Threads, and TikTok posts (on Threads: public reply and hide only — it has no DM or like API)
- **A/B Testing:** Test and optimize different message flows
- **Triggers:** Execute actions based on events within your bot
- **Webhooks & HTTP:** Integrate external APIs directly into your flows
- **Growth Tools:** Generate conversation starter links for each platform
- **Analytics:** Track performance metrics, user engagement, and campaign results
- **APIs, CLI, and MCP:** Build advanced agent workflows with MCP-compatible clients
|  |  |
| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
|  |  |
|  |  |
## Why ChatbotX?
| Feature | ManyChat | ChatbotX |
|---|---:|---:|
| Self-Hosted | ❌ | ✅ |
| White Label | ❌ | ✅ |
| CLI & MCP | ❌ | ✅ |
| Cost Growth | ✅ | ❌ |
| Public API | Limited | ✅ |
| Omnichannel | Limited | ✅ |
| AI Agents | Limited | ✅ |
| AI Credits | Add-on | BYOK |
## Tech Stack
- Node.js 24
- TypeScript 5
- pnpm 10 workspaces
- Turborepo
- Next.js 16 and React 19 for `apps/builder`
- uWebSockets.js gateway with Redis Streams for realtime messaging
- Drizzle ORM with PostgreSQL and pgvector
- Redis and BullMQ for queues and worker coordination
- RustFS / S3-compatible storage for uploaded assets
- Docker Compose for local infrastructure
## Quick Start
To have the project up and running, please follow the [Quick Start Guide](https://chatbotx.io/docs/quickstart).
**Self-hosting ChatbotX without developing on it?** Use **[chatbotx-docker-compose](https://github.com/ChatbotXIO/chatbotx-docker-compose)** — a standalone repo that runs the pre-built `ghcr.io` images with `docker compose up`, no local checkout of this monorepo required. The compose files in this repository (`docker-compose.yml`, `docker-compose.dev.yml`) provision local infrastructure only and expect the apps to run from source via `pnpm dev`.
## Project Structure
```text
.
|-- apps/
| |-- builder/ # Next.js web app and product builder
| |-- worker/ # background workers for chat, AI, triggers, webhooks, analytics, sequences
| |-- realtime/ # realtime server
| |-- cli/ # ChatbotX command line client
| `-- mcp-server/ # MCP server backed by public APIs
|-- integrations/
| |-- whatsapp/
| |-- messenger/
| |-- instagram/
| |-- threads/
| |-- telegram/
| |-- zalo/
| |-- tiktok/
| |-- webchat/
| |-- smtp/
| |-- openai/
| |-- google-sheets/
| `-- ... # email/CRM: mailchimp, klaviyo, active-campaign, drip, get-response, mailer-lite, moosend, sendgrid
|-- packages/
| |-- database/
| |-- ai/
| |-- auth/
| |-- business/
| |-- automated-response/
| |-- analytics/
| |-- event-bus/
| |-- mail/
| |-- imports/
| |-- flow-config/
| |-- variables/
| |-- sdk/
| |-- scheduler/
| |-- sequence-scheduler/
| |-- ui/
| `-- worker-config/
|-- docker-compose.yml
|-- pnpm-workspace.yaml
`-- turbo.json
```
## Development Commands
```bash
pnpm dev # run turbo dev
pnpm build # build all packages/apps through Turborepo
pnpm lint # run Ultracite lint
pnpm fix # run Ultracite fix
pnpm check:circular # check circular dependencies
pnpm check:unused # check unused files and dependencies
```
Useful package-level commands:
```bash
pnpm --filter builder dev
pnpm --filter worker dev
pnpm --filter realtime dev
pnpm --filter chatbotx dev:cli
pnpm --filter chatbotx-mcp dev:mcp
pnpm --filter @chatbotx.io/database db:studio
```
### Worker process modes
The worker image defaults to `worker standalone`: core queues, schedule, and
sequence workers share one Node process so common application code is loaded
once. Use `worker core` for local development without schedules, or `worker
` to isolate a workload such as `heavy`.
`worker all` remains available for one process per worker. It caps each child
heap at `WORKER_MAX_OLD_SPACE_MB` only when it is set (there is no default);
size it so the host has enough memory for every child. The `standalone` process retains
the normal V8 heap limit.
### Database pool sizing
`DATABASE_POOL_MAX` defaults to `10` connections per process. In the worker
Docker image, consolidated `worker standalone` and `worker core` modes default
to `80` (`SHARD_POOL_MAX` to `40`); set the variables explicitly to override.
Keep `replicas × (DATABASE_POOL_MAX + shards × SHARD_POOL_MAX)` at or below
PostgreSQL `max_connections`. The consolidated process runs about 350
concurrent job slots (trigger 100, sequence 100, webhook 50, …) over these pools.
## Services
The default Docker Compose stack includes:
- PostgreSQL with pgvector on `5432`
- Redis on `6379`
- RedisInsight on `5540`
- RustFS object storage on `9000` and console on `9001`
- MailHog SMTP on `1025` and UI on `8025`
- Adminer on `8080`
## Support
If ChatbotX helps you avoid expensive chatbot automation tools, please give us a ⭐ on GitHub.
We're also working hard to bring open-source mobile apps to **iOS and Android** this year
## License
ChatbotX' Community Edition is released as open source under the [MIT License](https://github.com/ChatbotXIO/ChatbotX/blob/main/LICENSE) and enterprise features are released under [Commercial License](https://github.com/ChatbotXIO/ChatbotX/blob/main/apps/builder/src/enterprise/LICENSE)
