AstrBot

<p align="center">

</p> <div align="center">

✨ 易上手的多平台 LLM 聊天机器人及开发框架 ✨

<a href="https://trendshift.io/repositories/12875" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12875" alt="Soulter%2FAstrBot | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

<img src="https://img.shields.io/badge/python-3.10+-blue.svg?style=for-the-badge&color=76bad9" alt="python">
<a href="https://hub.docker.com/r/soulter/astrbot"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/soulter/astrbot.svg?style=for-the-badge&color=76bad9"/></a>
<a href="https://qm.qq.com/cgi-bin/qm/qr?k=wtbaNx7EioxeaqS9z7RQWVXPIxg2zYr7&jump_from=webapi&authKey=vlqnv/AV2DbJEvGIcxdlNSpfxVy+8vVqijgreRdnVKOaydpc+YSw4MctmEbr0k5"><img alt="QQ_community" src="https://img.shields.io/badge/QQ群-775869627-purple?style=for-the-badge&color=76bad9"></a>
<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&color=76bad9"></a>

<a href="https://github.com/Soulter/AstrBot/blob/master/README_en.md">English</a> ｜
<a href="https://github.com/Soulter/AstrBot/blob/master/README_ja.md">日本語</a> ｜
<a href="https://astrbot.app/">查看文档</a> ｜
<a href="https://github.com/Soulter/AstrBot/issues">问题提交</a>

</div>

AstrBot 是一个松耦合、异步、支持多消息平台部署、具有易用的插件系统和完善的大语言模型（LLM）接入功能的聊天机器人及开发框架。

<!-- [](https://codecov.io/gh/Soulter/AstrBot) -->

[!WARNING]

请务必修改默认密码以及保证 AstrBot 版本 >= 3.5.13。

✨ 近期更新

<details><summary>1. AstrBot 现已自带知识库能力</summary>

📚 详见文档

</details>

2. AstrBot 现已支持接入 MCP 服务器！

✨ 主要功能

[!NOTE]
🪧 我们正基于前沿科研成果，设计并实现适用于角色扮演和情感陪伴的长短期记忆模型及情绪控制模型，旨在提升对话的真实性与情感表达能力。敬请期待 v3.6.0 版本！

1. 大语言模型对话。支持各种大语言模型，包括 OpenAI API、Google Gemini、Llama、Deepseek、ChatGLM 等，支持接入本地部署的大模型，通过 Ollama、LLMTuner。具有多轮对话、人格情境、多模态能力，支持图片理解、语音转文字（Whisper）。
2. 多消息平台接入。支持接入 QQ（OneBot、QQ 官方机器人平台）、QQ 频道、微信、企业微信、微信公众号、飞书、Telegram、钉钉、Discord、KOOK、VoceChat。支持速率限制、白名单、关键词过滤、百度内容审核。
3. Agent。原生支持部分 Agent 能力，如代码执行器、自然语言待办、网页搜索。对接 Dify 平台，便捷接入 Dify 智能助手、知识库和 Dify 工作流。
4. 插件扩展。深度优化的插件机制，支持开发插件扩展功能，极简开发。已支持安装多个插件。
5. 可视化管理面板。支持可视化修改配置、插件管理、日志查看等功能，降低配置难度。集成 WebChat，可在面板上与大模型对话。
6. 高稳定性、高模块化。基于事件总线和流水线的架构设计，高度模块化，低耦合。

[!TIP]
WebUI 在线体验 Demo: https://demo.astrbot.app/

用户名: astrbot, 密码: astrbot。

✨ 使用方式

Docker 部署

请参阅官方文档 使用 Docker 部署 AstrBot 。

Windows 一键安装器部署

请参阅官方文档 使用 Windows 一键安装器部署 AstrBot 。

宝塔面板部署

请参阅官方文档 宝塔面板部署 。

CasaOS 部署

社区贡献的部署方式。

请参阅官方文档 CasaOS 部署 。

手动部署

推荐使用 uv。

首先，安装 uv：

pip install uv

通过 Git Clone 安装 AstrBot：

git clone https://github.com/AstrBotDevs/AstrBot && cd AstrBot
uv run main.py

或者，直接通过 uvx 安装 AstrBot：

mkdir astrbot && cd astrbot
uvx astrbot init
# uvx astrbot run

或者请参阅官方文档 通过源码部署 AstrBot 。

在 Replit 上部署

在 雨云 上部署

⚡ 消息平台支持情况

平台	支持性
QQ(官方机器人接口)	✔
QQ(OneBot)	✔
微信个人号	✔
Telegram	✔
企业微信	✔
微信客服	✔
微信公众号	✔
飞书	✔
钉钉	✔
Slack	✔
Discord	✔
KOOK	✔
VoceChat	✔
微信对话开放平台	🚧
WhatsApp	🚧
小爱音响	🚧

⚡ 提供商支持情况

名称	支持性	类型	备注
OpenAI API	✔	文本生成	也支持 DeepSeek、Google Gemini、GLM、Kimi、xAI 等兼容 OpenAI API 的服务
Claude API	✔	文本生成
Google Gemini API	✔	文本生成
Dify	✔	LLMOps
阿里云百炼应用	✔	LLMOps
Ollama	✔	模型加载器	本地部署 DeepSeek、Llama 等开源语言模型
LM Studio	✔	模型加载器	本地部署 DeepSeek、Llama 等开源语言模型
LLMTuner	✔	模型加载器	本地加载 lora 等微调模型
硅基流动	✔	模型 API 服务平台
PPIO 派欧云	✔	模型 API 服务平台
OneAPI	✔	LLM 分发系统
Whisper	✔	语音转文本	支持 API、本地部署
SenseVoice	✔	语音转文本	本地部署
OpenAI TTS API	✔	文本转语音
GSVI	✔	文本转语音	GPT-Sovits-Inference
GPT-SoVITs	✔	文本转语音	GPT-Sovits-Inference
FishAudio	✔	文本转语音	GPT-Sovits 作者参与的项目
Edge TTS	✔	文本转语音	Edge 浏览器的免费 TTS
阿里云百炼 TTS	✔	文本转语音
Azure TTS	✔	文本转语音	Microsoft Azure TTS

❤️ 贡献

欢迎任何 Issues/Pull Requests！只需要将你的更改提交到此项目 ：)

如何贡献

你可以通过查看问题或帮助审核 PR（拉取请求）来贡献。任何问题或 PR 都欢迎参与，以促进社区贡献。当然，这些只是建议，你可以以任何方式进行贡献。对于新功能的添加，请先通过 Issue 讨论。

开发环境

AstrBot 使用 ruff 进行代码格式化和检查。

git clone https://github.com/Soulter/AstrBot
pip install pre-commit
pre-commit install

🌟 支持

• Star 这个项目！
• 在爱发电支持我！

✨ Demo

<details><summary>👉 点击展开多张 Demo 截图 👈</summary> <div align='center'> <img src="https://github.com/user-attachments/assets/4ee688d9-467d-45c8-99d6-368f9a8a92d8" width="600">

✨基于 Docker 的沙箱化代码执行器（Beta 测试）✨

<img src="https://github.com/user-attachments/assets/0378f407-6079-4f64-ae4c-e97ab20611d2" height=500>

✨ 多模态、网页搜索、长文本转图片（可配置） ✨

<img src="https://github.com/user-attachments/assets/e137a9e1-340a-4bf2-bb2b-771132780735" height=150> <img src="https://github.com/user-attachments/assets/480f5e82-cf6a-4955-a869-0d73137aa6e1" height=150>

✨ 插件系统——部分插件展示 ✨

<img src="https://github.com/user-attachments/assets/0cdbf564-2f59-4da5-b524-ce0e7ef3d978" width=600>

✨ WebUI ✨

</div> </details>

❤️ Special Thanks

特别感谢所有 Contributors 和插件开发者对 AstrBot 的贡献 ❤️

<a href="https://github.com/AstrBotDevs/AstrBot/graphs/contributors"> <img src="https://contrib.rocks/image?repo=AstrBotDevs/AstrBot" /> </a>

此外，本项目的诞生离不开以下开源项目：

• NapNeko/NapCatQQ - 伟大的猫猫框架
• wechatpy/wechatpy

⭐ Star History

[!TIP]
如果本项目对您的生活 / 工作产生了帮助，或者您关注本项目的未来发展，请给项目 Star，这是我维护这个开源项目的动力 <3

<div align="center">

</div>

Disclaimer

1. The project is protected under the AGPL-v3 opensource license.
2. The deployment of WeChat (personal account) utilizes Gewechat service. AstrBot only guarantees connectivity with Gewechat and recommends using a WeChat account that is not frequently used. In the event of account risk control, the author of this project shall not bear any responsibility.
3. Please ensure compliance with local laws and regulations when using this project.

私は、高性能ですから!