{"id":26775514,"url":"https://github.com/astrbotdevs/astrbot","last_synced_at":"2026-02-20T12:03:27.266Z","repository":{"id":64586511,"uuid":"575865240","full_name":"AstrBotDevs/AstrBot","owner":"AstrBotDevs","description":"✨ 易上手的多平台 LLM 聊天机器人及开发框架 ✨ 平台支持 QQ、QQ频道、Telegram、微信、企微、飞书 | MCP 服务器、OpenAI、DeepSeek、Gemini、硅基流动、月之暗面、Ollama、OneAPI、Dify 等。附带 WebUI。","archived":false,"fork":false,"pushed_at":"2025-04-19T05:45:06.000Z","size":30553,"stargazers_count":7861,"open_issues_count":211,"forks_count":504,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-04-19T13:00:54.248Z","etag":null,"topics":["agent","ai","chatbot","chatgpt","docker","gemini","gpt","llama","llm","mcp","openai","python","qq","qqbot","qqchannel","telegram"],"latest_commit_sha":null,"homepage":"https://astrbot.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AstrBotDevs.png","metadata":{"files":{"readme":"README.md","changelog":"changelogs/v3.4.0.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-12-08T13:27:46.000Z","updated_at":"2025-04-19T12:35:11.000Z","dependencies_parsed_at":"2023-02-15T23:31:11.909Z","dependency_job_id":"30fec4c2-6fcb-416b-8467-d5d0b748358a","html_url":"https://github.com/AstrBotDevs/AstrBot","commit_stats":{"total_commits":875,"total_committers":9,"mean_commits":97.22222222222223,"dds":0.01828571428571424,"last_synced_commit":"3da6158db5000903e9152c5390fc34ea528b5b5e"},"previous_names":["soulter/astrbot","astrbotdevs/astrbot"],"tags_count":96,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstrBotDevs%2FAstrBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstrBotDevs%2FAstrBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstrBotDevs%2FAstrBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstrBotDevs%2FAstrBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AstrBotDevs","download_url":"https://codeload.github.com/AstrBotDevs/AstrBot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250490774,"owners_count":21439209,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai","chatbot","chatgpt","docker","gemini","gpt","llama","llm","mcp","openai","python","qq","qqbot","qqchannel","telegram"],"created_at":"2025-03-29T03:18:40.430Z","updated_at":"2026-02-20T12:03:27.252Z","avatar_url":"https://github.com/AstrBotDevs.png","language":"Python","readme":"![AstrBot-Logo-Simplified](https://github.com/user-attachments/assets/ffd99b6b-3272-4682-beaa-6fe74250f7d9)\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://github.com/AstrBotDevs/AstrBot/blob/master/README_en.md\"\u003eEnglish\u003c/a\u003e ｜\n\u003ca href=\"https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.md\"\u003e日本語\u003c/a\u003e ｜\n\u003ca href=\"https://github.com/AstrBotDevs/AstrBot/blob/master/README_zh-TW.md\"\u003e繁體中文\u003c/a\u003e ｜\n\u003ca href=\"https://github.com/AstrBotDevs/AstrBot/blob/master/README_fr.md\"\u003eFrançais\u003c/a\u003e ｜\n\u003ca href=\"https://github.com/AstrBotDevs/AstrBot/blob/master/README_ru.md\"\u003eРусский\u003c/a\u003e\n\n\u003cdiv\u003e\n\u003ca href=\"https://trendshift.io/repositories/12875\" target=\"_blank\"\u003e\u003cimg src=\"https://trendshift.io/api/badge/repositories/12875\" alt=\"Soulter%2FAstrBot | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://hellogithub.com/repository/AstrBotDevs/AstrBot\" target=\"_blank\"\u003e\u003cimg src=\"https://api.hellogithub.com/v1/widgets/recommend.svg?rid=d127d50cd5e54c5382328acc3bb25483\u0026claim_uid=ZO9by7qCXgSd6Lp\u0026t=2\" alt=\"Featured｜HelloGitHub\" style=\"width: 250px; height: 54px;\" width=\"250\" height=\"54\" /\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003cdiv\u003e\n\u003cimg src=\"https://img.shields.io/github/v/release/AstrBotDevs/AstrBot?color=76bad9\" href=\"https://github.com/AstrBotDevs/AstrBot/releases/latest\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/python-3.10+-blue.svg\" alt=\"python\"\u003e\n\u003cimg src=\"https://deepwiki.com/badge.svg\" href=\"https://deepwiki.com/AstrBotDevs/AstrBot\"\u003e\n\u003ca href=\"https://zread.ai/AstrBotDevs/AstrBot\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/Ask_Zread-_.svg?style=flat\u0026color=00b0aa\u0026labelColor=000000\u0026logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K\u0026logoColor=ffffff\" alt=\"zread\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://hub.docker.com/r/soulter/astrbot\"\u003e\u003cimg alt=\"Docker pull\" src=\"https://img.shields.io/docker/pulls/soulter/astrbot.svg?color=76bad9\"/\u003e\u003c/a\u003e\n\u003cimg src=\"https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.soulter.top%2Fastrbot%2Fplugin-num\u0026query=%24.result\u0026suffix=%E4%B8%AA\u0026label=%E6%8F%92%E4%BB%B6%E5%B8%82%E5%9C%BA\u0026cacheSeconds=3600\"\u003e\n\u003cimg src=\"https://gitcode.com/Soulter/AstrBot/star/badge.svg\" href=\"https://gitcode.com/Soulter/AstrBot\"\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003ca href=\"https://astrbot.app/\"\u003e文档\u003c/a\u003e ｜\n\u003ca href=\"https://blog.astrbot.app/\"\u003eBlog\u003c/a\u003e ｜\n\u003ca href=\"https://astrbot.featurebase.app/roadmap\"\u003e路线图\u003c/a\u003e ｜\n\u003ca href=\"https://github.com/AstrBotDevs/AstrBot/issues\"\u003e问题提交\u003c/a\u003e\n\u003c/div\u003e\n\nAstrBot 是一个开源的一站式 Agentic 个人和群聊助手，可在 QQ、Telegram、企业微信、飞书、钉钉、Slack、等数十款主流即时通讯软件上部署，此外还内置类似 OpenWebUI 的轻量化 ChatUI，为个人、开发者和团队打造可靠、可扩展的对话式智能基础设施。无论是个人 AI 伙伴、智能客服、自动化助手，还是企业知识库，AstrBot 都能在你的即时通讯软件平台的工作流中快速构建 AI 应用。\n\n![521771166-00782c4c-4437-4d97-aabc-605e3738da5c (1)](https://github.com/user-attachments/assets/61e7b505-f7db-41aa-a75f-4ef8f079b8ba)\n\n## 主要功能\n\n1. 💯 免费 \u0026 开源。\n2. ✨ AI 大模型对话，多模态，Agent，MCP，Skills，知识库，人格设定，自动压缩对话。\n3. 🤖 支持接入 Dify、阿里云百炼、Coze 等智能体平台。\n4. 🌐 多平台，支持 QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 以及[更多](#支持的消息平台)。\n5. 📦 插件扩展，已有近 800 个插件可一键安装。\n6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) 隔离化环境，安全地执行任何代码、调用 Shell、会话级资源复用。\n7. 💻 WebUI 支持。\n8. 🌈 Web ChatUI 支持，ChatUI 内置代理沙盒、网页搜索等。\n9. 🌐 国际化（i18n）支持。\n\n\u003cbr\u003e\n\n\u003ctable align=\"center\"\u003e\n  \u003ctr align=\"center\"\u003e\n    \u003cth\u003e💙 角色扮演 \u0026 情感陪伴\u003c/th\u003e\n    \u003cth\u003e✨ 主动式 Agent\u003c/th\u003e\n    \u003cth\u003e🚀 通用 Agentic 能力\u003c/th\u003e\n    \u003cth\u003e🧩 900+ 社区插件\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cp align=\"center\"\u003e\u003cimg width=\"984\" height=\"1746\" alt=\"99b587c5d35eea09d84f33e6cf6cfd4f\" src=\"https://github.com/user-attachments/assets/89196061-3290-458d-b51f-afa178049f84\" /\u003e\u003c/p\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cp align=\"center\"\u003e\u003cimg width=\"976\" height=\"1612\" alt=\"c449acd838c41d0915cc08a3824025b1\" src=\"https://github.com/user-attachments/assets/f75368b4-e022-41dc-a9e0-131c3e73e32e\" /\u003e\u003c/p\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cp align=\"center\"\u003e\u003cimg width=\"974\" height=\"1732\" alt=\"image\" src=\"https://github.com/user-attachments/assets/e22a3968-87d7-4708-a7cd-e7f198c7c32e\" /\u003e\u003c/p\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cp align=\"center\"\u003e\u003cimg width=\"976\" height=\"1734\" alt=\"image\" src=\"https://github.com/user-attachments/assets/0952b395-6b4a-432a-8a50-c294b7f89750\" /\u003e\u003c/p\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## 快速开始\n\n#### Docker 部署(推荐 🥳)\n\n推荐使用 Docker / Docker Compose 方式部署 AstrBot。\n\n请参阅官方文档 [使用 Docker 部署 AstrBot](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot) 。\n\n#### uv 部署\n\n```bash\nuv tool install astrbot\nastrbot\n```\n\n#### 启动器一键部署（AstrBot Launcher）\n\n进入 [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) 仓库，在 Releases 页最新版本下找到对应的系统安装包安装即可。\n\n#### 宝塔面板部署\n\nAstrBot 与宝塔面板合作，已上架至宝塔面板。\n\n请参阅官方文档 [宝塔面板部署](https://astrbot.app/deploy/astrbot/btpanel.html) 。\n\n#### 1Panel 部署\n\nAstrBot 已由 1Panel 官方上架至 1Panel 面板。\n\n请参阅官方文档 [1Panel 部署](https://astrbot.app/deploy/astrbot/1panel.html) 。\n\n#### 在 雨云 上部署\n\nAstrBot 已由雨云官方上架至云应用平台，可一键部署。\n\n[![Deploy on RainYun](https://rainyun-apps.cn-nb1.rains3.com/materials/deploy-on-rainyun-en.svg)](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)\n\n#### 在 Replit 上部署\n\n社区贡献的部署方式。\n\n[![Run on Repl.it](https://repl.it/badge/github/AstrBotDevs/AstrBot)](https://repl.it/github/AstrBotDevs/AstrBot)\n\n#### Windows 一键安装器部署\n\n请参阅官方文档 [使用 Windows 一键安装器部署 AstrBot](https://astrbot.app/deploy/astrbot/windows.html) 。\n\n#### CasaOS 部署\n\n社区贡献的部署方式。\n\n请参阅官方文档 [CasaOS 部署](https://astrbot.app/deploy/astrbot/casaos.html) 。\n\n#### 手动部署\n\n首先安装 uv：\n\n```bash\npip install uv\n```\n\n通过 Git Clone 安装 AstrBot：\n\n```bash\ngit clone https://github.com/AstrBotDevs/AstrBot \u0026\u0026 cd AstrBot\nuv run main.py\n```\n\n或者请参阅官方文档 [通过源码部署 AstrBot](https://astrbot.app/deploy/astrbot/cli.html) 。\n\n#### 系统包管理器安装\n\n##### Arch Linux\n\n```bash\nyay -S astrbot-git\n# 或者使用 paru\nparu -S astrbot-git\n```\n\n#### 桌面端（Tauri）\n\n桌面端已迁移为独立仓库（Tauri）：[https://github.com/AstrBotDevs/AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop)。\n\n## 支持的消息平台\n\n**官方维护**\n\n- QQ\n- OneBot v11 协议实现\n- Telegram\n- 企微应用 \u0026 企微智能机器人\n- 微信客服 \u0026 微信公众号\n- 飞书\n- 钉钉\n- Slack\n- Discord\n- LINE\n- Satori\n- Misskey\n- Whatsapp (将支持)\n\n**社区维护**\n\n- [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter)\n- [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)\n- [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)\n\n## 支持的模型服务\n\n**大模型服务**\n\n- OpenAI 及兼容服务\n- Anthropic\n- Google Gemini\n- Moonshot AI\n- 智谱 AI\n- DeepSeek\n- Ollama (本地部署)\n- LM Studio (本地部署)\n- [AIHubMix](https://aihubmix.com/?aff=4bfH)\n- [优云智算](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot\u0026referral_code=FV7DcGowN4hB5UuXKgpE74)\n- [302.AI](https://share.302.ai/rr1M3l)\n- [小马算力](https://www.tokenpony.cn/3YPyf)\n- [硅基流动](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot)\n- [PPIO 派欧云](https://ppio.com/user/register?invited_by=AIOONE)\n- ModelScope\n- OneAPI\n\n**LLMOps 平台**\n\n- Dify\n- 阿里云百炼应用\n- Coze\n\n**语音转文本服务**\n\n- OpenAI Whisper\n- SenseVoice\n\n**文本转语音服务**\n\n- OpenAI TTS\n- Gemini TTS\n- GPT-Sovits-Inference\n- GPT-Sovits\n- FishAudio\n- Edge TTS\n- 阿里云百炼 TTS\n- Azure TTS\n- Minimax TTS\n- 火山引擎 TTS\n\n## ❤️ 贡献\n\n欢迎任何 Issues/Pull Requests！只需要将你的更改提交到此项目 ：)\n\n### 如何贡献\n\n你可以通过查看问题或帮助审核 PR（拉取请求）来贡献。任何问题或 PR 都欢迎参与，以促进社区贡献。当然，这些只是建议，你可以以任何方式进行贡献。对于新功能的添加，请先通过 Issue 讨论。\n\n### 开发环境\n\nAstrBot 使用 `ruff` 进行代码格式化和检查。\n\n```bash\ngit clone https://github.com/AstrBotDevs/AstrBot\npip install pre-commit\npre-commit install\n```\n\n## 🌍 社区\n\n### QQ 群组\n\n- 1 群：322154837\n- 3 群：630166526\n- 5 群：822130018\n- 6 群：753075035\n- 7 群：743746109\n- 8 群：1030353265\n- 开发者群：975206796\n\n### Telegram 群组\n\n\u003ca href=\"https://t.me/+hAsD2Ebl5as3NmY1\"\u003e\u003cimg alt=\"Telegram_community\" src=\"https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge\u0026color=76bad9\"\u003e\u003c/a\u003e\n\n### Discord 群组\n\n\u003ca href=\"https://discord.gg/hAVk6tgV36\"\u003e\u003cimg alt=\"Discord_community\" src=\"https://img.shields.io/badge/Discord-AstrBot-purple?style=for-the-badge\u0026color=76bad9\"\u003e\u003c/a\u003e\n\n## ❤️ Special Thanks\n\n特别感谢所有 Contributors 和插件开发者对 AstrBot 的贡献 ❤️\n\n\u003ca href=\"https://github.com/AstrBotDevs/AstrBot/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=AstrBotDevs/AstrBot\" /\u003e\n\u003c/a\u003e\n\n此外，本项目的诞生离不开以下开源项目的帮助：\n\n- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - 伟大的猫猫框架\n\n开源项目友情链接：\n\n- [NoneBot2](https://github.com/nonebot/nonebot2) - 优秀的 Python 异步 ChatBot 框架\n- [Koishi](https://github.com/koishijs/koishi) - 优秀的 Node.js ChatBot 框架\n- [MaiBot](https://github.com/Mai-with-u/MaiBot) - 优秀的拟人化 AI ChatBot\n- [nekro-agent](https://github.com/KroMiose/nekro-agent) - 优秀的 Agent ChatBot\n- [LangBot](https://github.com/langbot-app/LangBot) - 优秀的多平台 AI ChatBot\n- [ChatLuna](https://github.com/ChatLunaLab/chatluna) - 优秀的多平台 AI ChatBot Koishi 插件\n- [Operit AI](https://github.com/AAswordman/Operit) - 优秀的 AI 智能助手 Android APP\n\n## ⭐ Star History\n\n\u003e [!TIP]\n\u003e 如果本项目对您的生活 / 工作产生了帮助，或者您关注本项目的未来发展，请给项目 Star，这是我们维护这个开源项目的动力 \u003c3\n\n\u003cdiv align=\"center\"\u003e\n\n[![Star History Chart](https://api.star-history.com/svg?repos=astrbotdevs/astrbot\u0026type=Date)](https://star-history.com/#astrbotdevs/astrbot\u0026Date)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n_陪伴与能力从来不应该是对立面。我们希望创造的是一个既能理解情绪、给予陪伴，也能可靠完成工作的机器人。_\n\n_私は、高性能ですから!_\n\n\u003cimg src=\"https://files.astrbot.app/watashiwa-koseino-desukara.gif\" width=\"100\"/\u003e\n\n\u003c/div\u003e\n","funding_links":[],"categories":["Chatbots"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrbotdevs%2Fastrbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fastrbotdevs%2Fastrbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrbotdevs%2Fastrbot/lists"}