Self-host ChatterMate
v1.0.27AI customer support with human handoff and omnichannel
- Stars
- 148
- Ports
- 80 (Frontend web server), 8000 (Backend API server)
- Requires
- PostgreSQL
chattermate/backend
What is ChatterMate?
This platform helps businesses automate 24/7 customer service while keeping human agents available for complex issues. An AI chatbot learns from your knowledge base and handles routine questions, transferring to your team when needed. You can choose from multiple AI providers like OpenAI, Anthropic, Google, Mistral, and others using your own API keys. The system includes a visual workflow builder for designing conversation flows, native Shopify integration for e-commerce, a WordPress plugin, and AI-powered ticketing that investigates issues automatically. It connects to 9 messaging channels including web chat, WhatsApp, Telegram, Slack, and email. Deployment uses Docker Compose with pre-built images, requiring PostgreSQL with pgvector and Redis. The core is Apache-2.0 licensed with commercial enterprise features available separately.
Should you self-host ChatterMate?
ChatterMate scores 46/100 on selfhost.directory (how scoring works) and ranks #12 of 14 in Customer Support. It has 148 GitHub stars.
It shipped 10 stable releases in the past year. The latest, v1.0.27, came out on 19 October 2026. New versions land roughly every 10 days.
Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is chatwoot (84/100, 38 501 stars). It scores higher overall, so compare the two before you pick. See ChatterMate vs chatwoot side by side.
Features
- AI Chatbot with Human Handoff
- AI Ticketing
- Analytics Dashboard
- Auto-Translation
- Custom theming
- File attachments
- Knowledge Base Training
- Lead Capture
- Multi-Model AI Support
- Omnichannel messaging
- Role-based Access Control
- Shopify integration
- Visual Workflow Builder
- Widget Authentication
- WordPress Plugin
ChatterMate README
FAQ
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.
Can I self-host ChatterMate?
Yes, run the full stack (Postgres, Redis, backend, frontend) on your own infrastructure with npm install -g chattermate-deploy.
Does ChatterMate work with WordPress?
Yes, download the WordPress plugin, install via Plugins → Add New → Upload Plugin, then enter your Widget ID under Settings → ChatterMate Chat.
Does ChatterMate work with Shopify?
Yes, install from the Shopify App Store to answer order-status, shipping, and product questions from your store data. The widget also embeds on any website.
Can the AI hand off conversations to a human agent?
Yes, human handoff is a core feature. The AI detects frustration or explicit requests and transfers with full context, respecting business hours and agent availability.
Is ChatterMate free and open source?
Yes, the core platform is Apache-2.0 licensed and free for personal and commercial use, including self-hosted production deployments. There's also a free hosted plan.
What is ChatterMate?
ChatterMate is an open-source AI customer support platform that combines an AI chatbot trained on your knowledge base with human agents in a shared inbox.
More in Helpdesk
chatwootSelf-hosted, open-source customer support desk that unifies live chat, email, WhatsApp and social channels into one shared inbox and adds a built-in help center portal.
Frappe HelpdeskSelf-hosted open-source helpdesk with tickets, SLAs, knowledge base, and email integration. Unlimited agents, AGPL-3.0.
FreeScoutA self-hosted, open-source help desk & shared mailbox — Zendesk / Help Scout alternative on PHP & MySQL, with unlimited agents and tickets.
GLPIGLPI is a self-hosted, open-source IT asset management and service desk with CMDB, ticketing, and ITIL workflows for teams.
iTopiTop is a self-hosted, open-source ITSM platform with configurable CMDB, helpdesk, change management, and ITIL processes. Runs on PHP/MariaDB.
ITSM-NGITSM-NG is a self-hosted, open-source ITSM platform forked from GLPI with ticketing, asset management, and ITIL processes.
LibredeskFree, open-source omnichannel support desk you self-host as one binary: shared inbox for live chat, email and WhatsApp, plus help center, AI assistant and automations.
OpenSupportsOpenSupports is a self-hosted, open-source PHP/MySQL helpdesk with responsive UI, multi-language support, custom responses, articles/FAQs, and staff departments.
osTicketA self-hosted, open-source help desk that turns email, web-form and API enquiries into tickets with filter routing, SLA plans, custom fields and a customer portal.
OTOBOOTOBO is a self-hosted, open-source ticketing platform for IT helpdesks with ticketing, knowledge base, ITSM/CMDB, automation, and self-service portal.
OwlySelf-hosted AI support agent unifying WhatsApp, Email, and Phone with cross-channel identity, knowledge base, automation, and tickets.
pawpaw is a self-hosted, open-source Django ticket system for teams to track and resolve issues with threaded discussions, attachments, team access control, and email.
0 comments