Skip to content

ChatbotXIO/ChatbotX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

463 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

ChatbotX omnichannel AI chatbot hero

✨ Features

  • Visual Flow Builder: Drag-and-drop chatbot builder with 15+ node types
  • AI Agent: AI-powered responses and actions using OpenAI, DeepSeek, or Gemini
  • 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
  • Multi-Platform: Connect across WhatsApp, Facebook, Instagram, Telegram, Zalo, Email, and Webchat
  • Rich Messaging: Support for buttons, quick replies, catalogs, 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

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
|   |-- partysocket/   # 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/
|-- packages/
|   |-- database/
|   |-- ai/
|   |-- analytics/
|   |-- public-apis/
|   |-- 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 partysocket 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

License

ChatbotX' Community Edition is released as open source under the AGPLv3 license and enterprise features are released under Commercial License