Open-source AI customer support platform with human handoff. A no-code AI chatbot for 24/7 customer service automation — multi-model AI (OpenAI, Anthropic Claude, Google Gemini, Mistral, xAI Grok, DeepSeek, Groq), intelligent AI-to-human handover, Shopify & e-commerce support, Slack and Jira integrations, visual workflow builder, and a fully themeable chat widget. Use the free hosted service or self-host it as an open-source alternative to Intercom, Zendesk, and Chatbase.
Documentation | Live Demo | Free Signup | Shopify App | WordPress Plugin
- Why ChatterMate?
- Features
- ChatterMate vs. Intercom, Zendesk & Chatbase
- Demo
- Quick Start
- Installation
- Deployment
- FAQ
- Roadmap
- Contributing
- Support
ChatterMate is a no-code AI customer support platform that enables businesses to provide 24/7 customer service through intelligent AI agents. Your AI chatbot handles common queries, escalates complex issues to human agents when needed, and continuously learns from your knowledge base. Integrate the chat widget on any website — or any Shopify store — with a single line of code.
Perfect for: e-commerce and Shopify stores, SaaS companies, help desks, customer success teams, and any business looking to automate customer support while maintaining a human touch.
| Feature | Description |
|---|---|
| 🤝 Smart Human Handoff | Intelligent AI-to-human transfer with business hours awareness, real-time availability detection, and context-aware escalation messages. |
| 🛍️ Shopify & E-commerce Support | Native Shopify integration (App Store listing) — answer order, shipping, and product questions from store data. Works for any online store. |
| 📝 WordPress Plugin | Official WordPress plugin (download) — add the chat widget to any WordPress site by entering your Widget ID. No theme edits required. |
| 🧠 Multi-Model AI Support | Choose your AI provider — OpenAI, Anthropic (Claude), Google Gemini, Mistral, xAI (Grok), DeepSeek, and Groq — with your own API key, or enter a custom model ID. Switch providers anytime without code changes. |
| 💬 Ask Anything Mode | Let visitors start conversations instantly — no signup or email required. Perfect for Q&A, documentation assistants, and exploratory chat experiences. |
| 📎 File Attachments | Customers can share images, PDFs, Word docs, spreadsheets, and more directly in chat. Secure uploads with S3 storage and magic byte validation. |
| 🌍 Auto Translation | Multilingual support with configurable default language per workflow. Serve customers globally in their preferred language. |
| 🎫 Jira Ticket Creation | Create and manage Jira tickets directly from chat conversations. OAuth 2.0 secure integration with automatic ticket tracking. |
| 🔑 Widget Authentication | Token-based security for embedded widgets. Support both public Q&A and private authenticated conversations. |
| 💼 Slack Integration | Connect your Slack workspace for internal product support. Teams get AI-powered assistance directly in Slack channels. |
| 🧩 Visual Workflow Builder | Design conversation flows with a drag-and-drop interface. Branching logic, conditional responses, and multi-step workflows without coding. |
Build sophisticated conversation flows visually with our intuitive workflow builder:
Workflow Builder Features:
- Drag-and-drop nodes - AI responses, human handoff, conditions, and more
- Branching logic - Create different paths based on user input
- Node types - Start, AI Response, Human Transfer, Condition, End nodes
- Real-time preview - Test workflows before deploying
- Version control - Save and restore workflow versions
| Feature | Description |
|---|---|
| 🤖 AI-Powered Responses | Context-aware AI with conversation memory across sessions |
| 📊 Analytics Dashboard | Real-time monitoring, conversation insights, and performance metrics |
| 📚 Knowledge Base Training | Train your AI with domain-specific knowledge and FAQs |
| 🎨 Custom Theming | Fully customizable chat widget to match your brand |
| 🔐 Role-Based Access Control | Granular permissions for team members |
| 🌐 Open Source & Self-Hosted | Full control over your data with self-hosting option |
ChatterMate is a free, open-source alternative to Intercom, Zendesk AI, and Chatbase — with AI answers and human handoff in one inbox:
| ChatterMate | Intercom | Zendesk AI | Chatbase | |
|---|---|---|---|---|
| Open source (Apache-2.0) | ✅ | ❌ | ❌ | ❌ |
| Self-hosting / data ownership | ✅ | ❌ | ❌ | ❌ |
| AI answers from your knowledge base | ✅ | ✅ | ✅ | ✅ |
| Built-in human handoff + shared inbox | ✅ | ✅ | ✅ | |
| Bring your own AI model (OpenAI, Claude, Gemini, Grok, +more) | ✅ | ❌ | ❌ | |
| Visual no-code workflow builder | ✅ | ✅ | ❌ | |
| Free tier | ✅ | trial only | trial only | ✅ |
| Per-AI-resolution fees | ❌ none | $0.99/resolution | usage-based | credit-based |
Detailed comparisons: ChatterMate vs Chatbase · ChatterMate vs Chatwoot
There are two ways to run ChatterMate. Most people want the hosted service — sign up and manage everything from the dashboard, the CLI, or an AI agent. Self-host with Docker only if you need to run ChatterMate on your own infrastructure.
- Sign up: app.chattermate.chat — free, no card required.
- Manage from your terminal, automate, or drive it with an AI agent using the ChatterMate CLI:
# The ChatterMate CLI — sign up, mint tokens, and manage agents, workflows & knowledge
pip install chattermate-cli # installs the `chattermate` command
chattermate signup --name "Acme Inc" --domain acme.com --admin-email you@acme.com
chattermate agent create --name "Support" --type customer_support -i "Be concise and friendly"
chattermate knowledge add-url --website https://docs.acme.com --agent-id <agent-id>➡️ AI Agent & Automation Quickstart · CLI reference · MCP server
🤖 Building an AI agent that sets up ChatterMate? Start at
chattermate.chat/llms.txt, follow the agent quickstart, or connect the MCP server to configure ChatterMate over MCP.
Run the full ChatterMate stack on your own infrastructure with the self-host CLI (Docker-based):
# Install the self-host / deployment CLI
npm install -g chattermate-deploy
# Scaffold a project, then start the full stack (Postgres, Redis, backend, frontend, worker)
chattermate-deploy init my-chattermate-project
cd my-chattermate-project
chattermate-deploy start # then open http://localhost/Self-host CLI commands
chattermate-deploy init <project-name> # Scaffold a new self-hosted project
chattermate-deploy start # Start all services (Docker)
chattermate-deploy stop # Stop all services
chattermate-deploy status # Check service status
chattermate-deploy logs # View service logs
chattermate-deploy reset # Reset and remove all data
⚠️ Two differentchattermatecommands — don't mix them up. The hosted CLI (pip install chattermate-cli) signs you up and manages agents/knowledge against the ChatterMate API. The self-host CLI (npm install -g chattermate-deploy) scaffolds and runs the Docker stack. They are separate tools that happen to share thechattermatename.
Prefer the hosted service? Skip this section — just sign up and/or use the ChatterMate CLI (
pip install chattermate-cli). The methods below are for self-hosting.
For Self-Host CLI (Recommended)
- Node.js 16+
- Docker & Docker Compose
- npm or yarn
For Manual Installation
- Python 3.12+
- PostgreSQL 14+ (with Vector extension)
- Firebase Project (for push notifications)
- Redis (optional, for rate limiting and multi-server socket deployment)
The self-host CLI (chattermate-deploy, installed via npm) scaffolds and runs the Docker stack.
This is not the account CLI — for signup and agent management see the
ChatterMate CLI.
npm install -g chattermate-deploy
chattermate-deploy init my-project
cd my-project
chattermate-deploy start# Build and start all services
docker compose up --build
# Run in background
docker compose up -d
# Stop services
docker compose down
# View logs
docker compose logs -fClick to expand manual installation steps
cd backend
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
# Set up environment variables
cp .env.example .env
# Configure .env with your credentials
# Database setup
alembic upgrade head
# To generate revisions if any model changes
alembic revision --autogenerate -m "Changes description"cd frontend
npm install
cp .env.example .envFor Web Push notification, generate a firebase config and place it in backend/app/config/firebase-config.json
Backend
# Development
uvicorn app.main:app --reload --port 8000
# Run Knowledge Processor (in a separate terminal)
python -m app.workers.run_knowledge_processorFrontend
# Development
npm run dev
# Build Widget for chat integration
npm run build:widget
# Build Web Client
npm run build:webclientBackend
pytest tests/Frontend
npm run test:unit # Unit tests
npm run test:e2e # E2E testsPre-built Docker images are available:
# Pull images
docker pull chattermate/frontend:latest
docker pull chattermate/backend:latest
# Run with production compose
docker compose -f docker-compose.prod.yml up -dClick for production deployment without Docker
Backend
pip install gunicorn
gunicorn app.main:app \
--workers 4 \
--worker-class uvicorn.workers.UvicornWorker \
--bind 0.0.0.0:8000 \
--access-logfile - \
--error-logfile - \
--log-level info \
--timeout 120Knowledge Processor (systemd)
sudo tee /etc/systemd/system/chattermate-knowledge-processor.service << EOF
[Unit]
Description=ChatterMate Knowledge Processor
After=network.target
[Service]
User=chattermate
Group=chattermate
WorkingDirectory=/path/to/chattermate/backend
Environment="PATH=/path/to/chattermate/backend/venv/bin"
ExecStart=/path/to/chattermate/backend/venv/bin/python -m app.workers.run_knowledge_processor
Restart=always
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable chattermate-knowledge-processor
sudo systemctl start chattermate-knowledge-processorFrontend
npm run build
# Serve using nginx or other web serverWhat is ChatterMate? ChatterMate is an open-source AI customer support platform. It combines an AI chatbot (trained on your knowledge base) with human agents in a shared inbox, so AI handles routine questions 24/7 and hands off to your team when it matters.
Is ChatterMate free and open source? Yes. The core platform is Apache-2.0 licensed — free for personal and commercial use, including self-hosted production deployments. There's also a free hosted plan at app.chattermate.chat.
Can the AI hand off conversations to a human agent? Yes — human handoff is a core feature, not an add-on. ChatterMate detects frustration or explicit requests for a human and transfers the conversation with full context, respecting business hours and agent availability.
Does ChatterMate work with Shopify? Yes. Install it from the Shopify App Store to answer order-status, shipping, and product questions directly from your store data. The widget also embeds on any other e-commerce or website platform with one line of code.
Does ChatterMate work with WordPress? Yes. Download the WordPress plugin, install it via Plugins → Add New → Upload Plugin, then enter your Widget ID under Settings → ChatterMate Chat. The chat launcher appears on your site with no theme edits. A WordPress.org directory listing is in progress.
Can I self-host ChatterMate?
Yes. Run the full stack (Postgres, Redis, backend, frontend) on your own infrastructure with npm install -g chattermate-deploy — see Quick Start. Self-hosting gives you complete data ownership.
Which AI models does ChatterMate support? OpenAI, Anthropic (Claude), Google Gemini, Mistral, xAI (Grok), DeepSeek, and Groq — bring your own API key, or enter a custom model ID for any model a provider supports. You can switch providers at any time without code changes.
- 🔄 Auto Follow-up System - Automated follow-ups for idle customers
- 📘 Customer Contact Management - CRM-like contact organization
- 🤝 Human Agent AI Suggestions - AI-powered response suggestions for agents
- 📞 AI Voice Chat - Voice-enabled AI conversations
- 🔌 More Integrations - Zendesk, Intercom, and more
We welcome contributions! Here's how to get started:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow PEP 8 style guide
- Write tests for new features
- Update documentation as needed
- Add type hints to new functions
- 📖 Documentation: docs.chattermate.chat
- 🐛 Issues: GitHub Issues
- 📧 Email: support@chattermate.chat
ChatterMate follows an open-core model:
Open Source Core (Apache-2.0)
- Free for personal and commercial use — including proprietary and SaaS deployments
- No source-disclosure or copyleft obligations
- Includes an explicit patent grant
- See LICENSE and NOTICE
Enterprise features & support
- Advanced/enterprise capabilities are provided separately under a commercial arrangement
- Priority support, warranties, and indemnification available
- Contact: contact@chattermate.chat
Contributions are accepted under Apache-2.0 with a Developer Certificate of Origin sign-off — see CONTRIBUTING.md.
Made with ❤️ by the ChatterMate team
Keywords: AI customer support, AI chatbot, Shopify chatbot, WordPress chatbot, WordPress chat plugin, ecommerce chatbot, customer support automation, open source help desk, live chat software, self-hosted chatbot, Intercom alternative, Zendesk alternative, Chatbase alternative, no-code chatbot builder, human handoff, Jira integration, Slack bot, multilingual chatbot