AstrBotDevs / AstrBot

AstrBot is an open-source all-in-one Agent chatbot platform that integrates with mainstream instant messaging apps. It provides reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether you’re building a personal AI companion, intelligent customer service, automation assistant, or enterprise knowledge base, AstrBot enables you to quickly build production-ready AI applications within your IM platform workflows.

AstrBot 是一个开源的一体化 Agent 聊天机器人平台，集成了主流即时通讯软件。它为个人、开发者和团队提供了可靠且可扩展的对话式 AI 基础设施。无论您是想构建个人 AI 伴侣、智能客服、自动化助手还是企业知识库，AstrBot 都能让您在即时通讯平台的工作流中快速构建生产级的 AI 应用。

Key Features

核心功能

💯 Free & Open Source. 💯 免费且开源。
✨ AI LLM Conversations, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona Settings, Auto Context Compression. ✨ AI 大模型对话、多模态、智能体 (Agent)、MCP、技能、知识库、人设设置、自动上下文压缩。
🤖 Supports integration with Dify, Alibaba Cloud Bailian, Coze, and other agent platforms. 🤖 支持与 Dify、阿里云百炼、扣子 (Coze) 等智能体平台集成。
🌐 Multi-Platform: QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack, and more. 🌐 多平台支持：QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 等。
📦 Plugin Extensions with 1000+ plugins available for one-click installation. 📦 插件扩展，拥有 1000+ 可一键安装的插件。
🛡️ Agent Sandbox for isolated, safe execution of code, shell calls, and session-level resource reuse. 🛡️ 智能体沙箱，用于隔离、安全地执行代码、Shell 调用以及会话级资源复用。
💻 WebUI Support. 💻 支持 WebUI。
🌈 Web ChatUI Support with built-in agent sandbox and web search. 🌈 支持 Web ChatUI，内置智能体沙箱和网页搜索功能。
🌐 Internationalization (i18n) Support. 🌐 支持国际化 (i18n)。
💙 Role-playing & Emotional Companionship. 💙 角色扮演与情感陪伴。
✨ Proactive Agent. ✨ 主动式智能体。
🚀 General Agentic Capabilities. 🚀 通用智能体能力。
🧩 1000+ Community Plugins. 🧩 1000+ 社区插件。

Quick Start: One-Click Deployment

快速开始：一键部署

Note: Requires uv to be installed. For macOS users: due to macOS security checks, the first run of the astrbot command may take longer (about 10-20s). For users who want to quickly experience AstrBot, are familiar with command-line usage, and can install a uv environment on their own, we recommend the uv one-click deployment method ⚡️:

注意： 需要安装 uv。对于 macOS 用户：由于 macOS 的安全检查，首次运行 astrbot 命令可能需要较长时间（约 10-20 秒）。对于想要快速体验 AstrBot、熟悉命令行操作并能自行安装 uv 环境的用户，我们推荐使用 uv 一键部署方式 ⚡️：

uv tool install astrbot --python 3.12
astrbot init # Only execute this command for the first time to initialize the environment
astrbot run

Update astrbot: 更新 astrbot：

uv tool upgrade astrbot --python 3.12

One-Click Cloud Deployment (RainYun)

云端一键部署 (雨云)

For users who want one-click deployment and do not want to manage servers themselves, we recommend RainYun’s one-click cloud deployment service ☁️.

对于希望一键部署且不想自行管理服务器的用户，我们推荐使用雨云 (RainYun) 的云端一键部署服务 ☁️。

Docker Deployment

Docker 部署

For users familiar with containers and looking for a more stable, production-ready deployment method, we recommend deploying AstrBot with Docker / Docker Compose. Please refer to the official documentation: Deploy AstrBot with Docker.

对于熟悉容器技术并寻求更稳定、生产级部署方式的用户，我们推荐使用 Docker / Docker Compose 部署 AstrBot。请参考官方文档：使用 Docker 部署 AstrBot。

❤️ Contributing

❤️ 贡献指南

Issues and Pull Requests are always welcome! Feel free to submit your changes to this project :)

我们随时欢迎提交 Issue 和 Pull Request！欢迎随时向本项目提交您的改进 :)

How to Contribute 如何贡献

You can contribute by reviewing issues or helping with pull request reviews. Any issues or PRs are welcome to encourage community participation. Of course, these are just suggestions—you can contribute in any way you like. For adding new features, please discuss through an Issue first.

您可以通过审查 Issue 或协助审查 Pull Request 来做出贡献。我们欢迎任何形式的 Issue 或 PR 以鼓励社区参与。当然，这些只是建议——您可以以任何您喜欢的方式做出贡献。如需添加新功能，请先通过 Issue 进行讨论。