Skip to content

ChatbotXIO/ChatbotX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

650 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ChatbotX Logo

License

Agentic chat marketing platform built for OpenClaw, Hermes, and Claude
An alternative to ManyChat, Chatfuel, Wati, Respond, etc...

Website | Roadmap | Docs | Discord

TypeScript Next.js Turborepo pnpm PostgreSQL Redis Docker MCP

WhatsApp Messenger Instagram Telegram Zalo TikTok Email Website

Watch the YouTube TutorialsΒ»

Register Β· CLI Β· MCP Β· Public API

ChatbotX Omnichannel

✨ Features

  • Omnichannel: WhatsApp, Facebook, Instagram, 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
  • 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
Omnichannel Team Inbox Smart Contact Import
Visual Flow Builder Built-in AI Agents

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
  • PartyKit / PartySocket 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.

Project Structure

.
|-- 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/
|   |-- 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

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:

pnpm --filter builder dev
pnpm --filter worker dev
pnpm --filter realtime dev
pnpm --filter chatbotx-cli dev:cli
pnpm --filter chatbotx-mcp-server dev:mcp
pnpm --filter @chatbotx.io/database db:studio

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 and enterprise features are released under Commercial License