<div align="center">

<img src="https://raw.githubusercontent.com/PersonaliAI/chatty/main/backend/assets/chatty-icon.png" alt="Chatty" width="88" /> <img src="https://raw.githubusercontent.com/PersonaliAI/chatty/main/backend/assets/readme-icon.png" alt="Chatty" width="88" />

Chatty by PersonaliAI

<p> <a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.es.md">Español</a> </p>

Open-source AI agent trained on your store and content.<br />Answers customer questions, captures leads, and books meetings on website, WhatsApp & Slack.

<p align="center"> <a href="https://chatty.personaliai.com"><b>🚀 Live Demo</b></a> &nbsp;·&nbsp; <a href="https://chatty.personaliai.com/signup"><b>☁️ Chatty Cloud (Free 14-day trial)</b></a> &nbsp;·&nbsp; <a href="#-quick-start-docker-compose"><b>⚡ Quickstart (5 min)</b></a> &nbsp;·&nbsp; <a href="https://docs.chatty.personaliai.com"><b>📖 Documentation</b></a> </p> <p align="center"> <a href="https://render.com/deploy?repo=https://github.com/PersonaliAI/chatty"><img src="https://render.com/images/deploy-to-render-button.svg" alt="Deploy to Render" /></a> &nbsp; <a href="https://railway.com/template/chatty-open-source-ai-customer-support-a"><img src="https://railway.com/button.svg" alt="Deploy on Railway" /></a> </p>

Chatty is an open-source, self-hostable Zendesk and Intercom alternative for stores and modern businesses that need autonomous AI customer support with human takeover, WooCommerce sync, and calendar scheduling.

Run the application containers on your own host while keeping Supabase Auth, Postgres, Storage, and Realtime managed. The same deployment contract works on a VPS, Railway, Render, or another Docker host without touching the live Supabase project.

Chatty Cloud (hosted) · Documentation · Data Processing (DPA) · Sub-processors · Performance Scorecard · Flow Builder · Widget Embed · Secure customer identity · Quick Start · Platform Runbook · MCP Server · AI Plugins · Omnichannel · WooCommerce

<br /> <br /> <p align="center"> <a href="screenshots/real-01-overview.png"><img src="screenshots/real-01-overview.png" alt="Chatty Executive Overview & Live Telemetry" width="100%" style="border-radius: 8px;" /></a> </p> </div>

---

Table of contents

• Why Chatty
• Live Dashboard Showcase (4K Retina)
• Performance Scorecard (A-F Auditing)
• Flow Builder & Integrations
• Widget Integration (3-Line Embed)
• Features
• 7-Channel Omnichannel Hub
• Visual Flow Builder Engine & Conditional Runtime
• WooCommerce Store Integration & Multimodal RAG
• LiveKit Voice Agent & SDKs
• Architecture
• Requirements
• Quick Start (Docker Compose)
• Self-Hosting, Step by Step
  • 1. Create and configure Supabase
  • 2. Apply the database schema
  • 3. Get your LLM key
  • 4. Configure environment variables
  • 5. Run it
  • 6. Verify the install
  • 7. Optional features
  • 8. Production deployment
  • 9. Updating
  • Troubleshooting
• Local Development (without Docker)
• Managed-Supabase platform runbook
• MCP Server & AI Coding Plugins (Claude, Cursor, Codex)
• Environment Variable Reference
• Testing & CI
• GDPR & Enterprise Data Privacy
• Security
• Contributing
• License

Why Chatty

Every hosted chatbot SaaS charges per-seat or per-message and holds your conversation data. Chatty is open-core: run it yourself for free, or use Chatty Cloud - our own hosted version of this exact repo, if you'd rather skip the ops work. Either way you get the same feature set - streaming chat, RAG over your own documents, meeting booking, lead capture, WhatsApp/Slack channels, and a full MCP server so an AI agent can run the whole dashboard for you.

| Capability | Closed-source SaaS chatbots | Chatty | |---|---|---| | Data Ownership | Stored on third-party servers, vendor locked | Cloud: Hosted on Chatty Cloud with zero AI training guarantee<br>Self-Host: 100% in your own private Supabase instance | | Pricing | High per-seat fees & message overages | Self-host for $0 forever (MIT), or predictable flat-rate hosted cloud tiers | | LLM Choice | Locked to vendor models | Bring your own (BYOK): Gemini, OpenAI, Claude, OpenRouter, or local models | | Agent / MCP Access | None, or expensive enterprise add-on | Official 81-tool FastMCP server included (OAuth 2.0 PKCE & API Keys) | | Source Code & License | Proprietary closed source | MIT Licensed — 100% open-source, forkable, auditable, run anywhere |

🖥️ Live Dashboard Showcase (4K Retina)

All 22 core modules are captured from live production (chatty.personaliai.com/dashboard) in crisp 4K Retina (3840×2160) resolution, representing real hydrated application state:

<table width="100%"> <tr> <td width="50%" align="center"> <a href="screenshots/real-06-inbox.png"><img src="screenshots/real-06-inbox.png" alt="Omnichannel Live Helpdesk & SLA Inbox" width="100%" /></a> <br /> <b>Omnichannel Live Helpdesk & SLA Inbox</b> <br /> _{Real-time visitor threads, SLA breach warnings & 1-click human takeover} </td> <td width="50%" align="center"> <a href="screenshots/real-04-knowledge-base.png"><img src="screenshots/real-04-knowledge-base.png" alt="Knowledge Base & Vector Documents" width="100%" /></a> <br /> <b>Knowledge Base & Vector Documents</b> <br /> _{Multi-format ingestion, recursive crawler & 186k+ tokens indexed} </td> </tr> <tr> <td width="50%" align="center"> <a href="screenshots/real-18-voice-agent.png"><img src="screenshots/real-18-voice-agent.png" alt="LiveKit WebRTC Voice Studio" width="100%" /></a> <br /> <b>LiveKit WebRTC Voice Studio</b> <br /> _{Sub-500ms bidirectional audio, dynamic visualizers & multi-platform SDKs} </td> <td width="50%" align="center"> <a href="screenshots/real-08-flow-builder.png"><img src="screenshots/real-08-flow-builder.png" alt="Visual Conversation Flow Architect" width="100%" /></a> <br /> <b>Visual Conversation Flow Architect</b> <br /> _{Interactive decision tree graph with AI Flow Copilot & cycle validation} </td> </tr> <tr> <td width="50%" align="center"> <a href="screenshots/real-03-customizer.png"><img src="screenshots/real-03-customizer.png" alt="Live Widget Customizer & Style Studio" width="100%" /></a> <br /> <b>Live Widget Customizer & Style Studio</b> <br /> _{WYSIWYG live preview with automated WCAG AA/AAA contrast engine} </td> <td width="50%" align="center"> <a href="screenshots/real-16-analytics.png"><img src="screenshots/real-16-analytics.png" alt="Resolution Rates & Deflection Telemetry" width="100%" /></a> <br /> <b>Resolution Rates & Deflection Telemetry</b> <br /> _{Conversation volume, 100% deflection rate, and token usage heatmaps} </td> </tr> </table> <details> <summary><b>📸 Click to explore all 22 High-Resolution Production Dashboard Views</b></summary> <br />

| # | Module | Description | High-Res Capture | | :---: | :--- | :--- | :---: | | 01 | Executive Overview | 5-pillar health score, deflection rate & live 30-day KPIs | View 4K Image | | 02 | Chatbot Workspace | Multi-bot management, model switching (GPT-4o, Claude, Gemini) | View 4K Image | | 03 | Widget Customizer | 6-part styling palette, brand logo, WCAG contrast pass/fail | View 4K Image | | 04 | Knowledge Base | 52+ sources, 186k chars indexed, HNSW vector search | View 4K Image | | 05 | AI Playground | Sandboxed simulator with citation inspect drawer | View 4K Image | | 06 | Omnichannel Inbox | Unified helpdesk, live visitor presence, SLA breach timers | View 4K Image | | 07 | Campaigns | Proactive announcement modals, exit-intent & scroll triggers | View 4K Image | | 08 | Flow Builder | Drag-and-drop conversation canvas with AI Flow Copilot | View 4K Image | | 09 | Visitor Leads CRM | Automated lead extraction, GeoIP country/city telemetry, CSV export | View 4K Image | | 10 | Feedback & CSAT | Post-chat customer ratings, sentiment analysis & friction tags | View 4K Image | | 11 | Visitor Map | Interactive Leaflet geolocation map showing regional traffic | View 4K Image | | 12 | Meeting Scheduler | 2-way Google Calendar OAuth sync & automated Meet links | View 4K Image | | 13 | Inbound Mailbox | Resend email routing converting incoming emails to tick