better-chatbot

<img width="1184" height="576" alt="thumbnail" loading="lazy" src="https://github.com/user-attachments/assets/d6ba80ff-a62a-4920-b266-85c4a89d6076" /> [](https://modelcontextprotocol.io/introduction) [](https://localfirstweb.dev/) [](https://discord.gg/gCRu69Upnp) [](<https://vercel.com/new/clone?repository-url=https://github.com/cgoinglove/better-chatbot&env=BETTER_AUTH_SECRET&env=OPENAI_API_KEY&env=GOOGLE_GENERATIVE_AI_API_KEY&env=ANTHROPIC_API_KEY&envDescription=BETTER_AUTH_SECRET+is+required+(enter+any+secret+value).+At+least+one+LLM+provider+API+key+(OpenAI,+Claude,+or+Google)+is+required,+but+you+can+add+all+of+them.+See+the+link+below+for+details.&envLink=https://github.com/cgoinglove/better-chatbot/blob/main/.env.example&demo-title=better-chatbot&demo-description=An+Open-Source+Chatbot+Template+Built+With+Next.js+and+the+AI+SDK+by+Vercel.&products=[{"type":"integration","protocol":"storage","productSlug":"neon","integrationSlug":"neon"},{"type":"integration","protocol":"storage","productSlug":"upstash-kv","integrationSlug":"upstash"},{"type":"blob"}]>) 🚀 **[Live Demo](https://better-chatbot-demo.vercel.app/)** | See the experience in action in the [preview](#preview) below! #### Demo Chats - **MCP Tools Demo:** [Chat with Tools](https://better-chatbot-demo.vercel.app/export/a4820921-8012-496b-8a5d-13757050bafe) - **Image Generation Demo:** [Chat with Image Generation](https://better-chatbot-demo.vercel.app/export/452ad745-9efb-49ae-9114-10db15f1b827) ## Quick Start 🚀 > **Get your app running in minutes! No installation or payment required.** You only need **one AI Provider API Key** (OpenAI, Claude, Gemini, etc.). Everything else runs on free tiers - database, file storage, and hosting. 👉 **[Click this guide to deploy your site with just a few clicks](docs/tips-guides/vercel.md)** --- **Better Chatbot** - A better open-source AI chatbot for individuals and teams, inspired by ChatGPT, Claude, Grok, and Gemini. • **Multi-AI Support** - Integrates all major LLMs: OpenAI, Anthropic, Google, xAI, Ollama, and more • **Powerful Tools** - MCP protocol, web search, JS/Python code execution, data visualization • **Image Generation** - Create and edit images with AI models (OpenAI, Google Gemini, xAI) • **Automation** - Custom agents, visual workflows, artifact generation • **Collaboration** - Share agents, workflows, and MCP configurations with your team • **Voice Assistant** - Realtime voice chat with full MCP tool integration • **Intuitive UX** - Instantly invoke any feature with `@mention` • **Quick Start** - Deploy free with Vercel Deploy button Built with Vercel AI SDK and Next.js, combining the best features of leading AI services into one platform. ## Table of Contents - [Table of Contents](#table-of-contents) - [Preview](#preview) - [🧩 Browser Automation with Playwright MCP](#-browser-automation-with-playwright-mcp) - [🔗 Visual Workflows as Custom Tools](#-visual-workflows-as-custom-tools) - [🤖 Custom Agents](#-custom-agents) - [🎙️ Realtime Voice Assistant + MCP Tools](#️-realtime-voice-assistant--mcp-tools) - [⚡️ Quick Tool Mentions (`@`) \& Presets](#️-quick-tool-mentions---presets) - [🧭 Tool Choice Mode](#-tool-choice-mode) - [🛠️ Default Tools](#️-default-tools) - [🌐 Web Search](#-web-search) - [⚡️ JS,PYTHON Executor](#️-jspython-executor) - [📊 Data Visualization Tools](#-data-visualization-tools) - [Getting Started](#getting-started) - [Quick Start (Docker Compose Version) 🐳](#quick-start-docker-compose-version-) - [Quick Start (Local Version) 🚀](#quick-start-local-version-) - [Environment Variables](#environment-variables) - [📘 Guides](#-guides) - [🔌 MCP Server Setup \& Tool Testing](#-mcp-server-setup--tool-testing) - [🐳 Docker Hosting Guide](#-docker-hosting-guide) - [▲ Vercel Hosting Guide](#-vercel-hosting-guide) - [🗂️ File Storage Drivers](#️-file-storage-drivers) - [🎯 System Prompts \& Chat Customization](#-system-prompts--chat-customization) - [🔐 OAuth Sign-In Setup](#-oauth-sign-in-setup) - [🕵🏿 Adding openAI like providers](#-adding-openai-like-providers) - [🧪 E2E Testing Guide](#-e2e-testing-guide) - [💡 Tips](#-tips) - [💬 Temporary Chat Windows](#-temporary-chat-windows) - [🗺️ Roadmap](#️-roadmap) - [🙌 Contributing](#-contributing) - [💬 Join Our Discord](#-join-our-discord) > This project is evolving at lightning speed! ⚡️ We're constantly shipping new features and smashing bugs. **Star this repo** to join the ride and stay in the loop with the latest updates! ## Preview Get a feel for the UX — here's a quick look at what's possible. ### 🧩 Browser Automation with Playwright MCP ![preview](https://github.c