AstrBot README

The project's README from github.com/AstrBotDevs/AstrBot. As one markdown file: README.md.

AstrBot-Logo-Simplified

简体中文 | 繁體中文 | 日本語 | Français | Español | Русский


AstrBotDevs%2FAstrBot | Trendshift Featured|HelloGitHub

python zread Docker pull

Documentation | Blog | Roadmap | Issue Tracker | Email Support

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.

screenshot_1 5x_postspark_2026-02-27_22-37-45

Key Features

  1. 💯 Free & Open Source.
  2. ✨ AI LLM Conversations, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona Settings, Auto Context Compression.
  3. 🤖 Supports integration with Dify, Alibaba Cloud Bailian, Coze, and other agent platforms.
  4. 🌐 Multi-Platform: QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack, and more.
  5. 📦 Plugin Extensions with 1000+ plugins available for one-click installation.
  6. 🛡️ Agent Sandbox for isolated, safe execution of code, shell calls, and session-level resource reuse.
  7. 💻 WebUI Support.
  8. 🌈 Web ChatUI Support with built-in agent sandbox and web search.
  9. 🌐 Internationalization (i18n) Support.

Quick Start

One-Click Cloud Deployment (RainYun)

For users who want one-click 24-hour-online deployment and do not want to manage servers themselves, we recommend RainYun's one-click cloud deployment service ☁️:

Deploy on RainYun

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 tool install astrbot --python 3.12
astrbot init # Only execute this command for the first time to initialize the environment
astrbot run

Update astrbot:

uv tool upgrade astrbot --python 3.12

Docker Deployment

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.

Desktop Application Deployment

For users who want to use AstrBot on desktop and mainly use ChatUI, we recommend AstrBot App.

Visit AstrBot-desktop to download and install; this method is designed for desktop usage and is not recommended for server scenarios.

Launcher Deployment

For desktop users who also want fast deployment and isolated multi-instance usage, we recommend AstrBot Launcher.

Visit AstrBot Launcher to download and install.

More deployment methods

If you need panel-based management or deeper customization, see BT-Panel Deployment for BT Panel app-store setup, 1Panel Deployment for 1Panel app-market deployment, CasaOS Deployment for NAS/home-server visual deployment, and Manual Deployment for fully custom source-based installation with uv.

❤️ Sponsors

Welcome to sponsor us via Afdian or contact us.

sponsors

Supported Messaging Platforms

Connect AstrBot to your favorite chat platform.

Platform Maintainer
QQ Official
OneBot v11 protocol implementation Official
Telegram Official
Wecom & Wecom AI Bot Official
WeChat Official Accounts Official
Feishu (Lark) Official
DingTalk Official
Slack Official
Discord Official
LINE Official
Satori Official
KOOK Official
Misskey Official
Mattermost Official
WhatsApp (Coming Soon) Official
Matrix Community
Rocket.Chat Community
VoceChat Community

Supported Model Services

Service Type
OpenAI and Compatible Services LLM Services
Anthropic LLM Services
Google Gemini LLM Services
Moonshot AI LLM Services
Zhipu AI LLM Services
DeepSeek LLM Services
Ollama (Self-hosted) LLM Services
LM Studio (Self-hosted) LLM Services
MiraRouter LLM Services (API Gateway, supports all models)
AIHubMix LLM Services (API Gateway, supports all models)
CompShare LLM Services
302.AI LLM Services
TokenPony LLM Services
SiliconFlow LLM Services
PPIO Cloud LLM Services
ModelScope LLM Services
OneAPI LLM Services
Dify LLMOps Platforms
Alibaba Cloud Bailian Applications LLMOps Platforms
Coze LLMOps Platforms
OpenAI Whisper Speech-to-Text Services
SenseVoice Speech-to-Text Services
Xiaomi MiMo Omni Speech-to-Text Services
OpenAI TTS Text-to-Speech Services
Gemini TTS Text-to-Speech Services
GPT-Sovits-Inference Text-to-Speech Services
GPT-Sovits Text-to-Speech Services
FishAudio Text-to-Speech Services
Edge TTS Text-to-Speech Services
Alibaba Cloud Bailian TTS Text-to-Speech Services
Azure TTS Text-to-Speech Services
Minimax TTS Text-to-Speech Services
Xiaomi MiMo TTS Text-to-Speech Services
Volcano Engine TTS Text-to-Speech Services

❤️ Contributing

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

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.

Development Environment

AstrBot uses ruff for code formatting and linting.

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

🌍 Community

QQ Groups

We have 15+ chat groups, please see: Community for details.

Discord Server

Discord_community

❤️ Special Thanks

Special thanks to all Contributors and plugin developers for their contributions to AstrBot ❤️

Open Source Friends ❤️

⭐ Star History

[!TIP] If this project has helped you in your life or work, or if you're interested in its future development, please give the project a Star. It's the driving force behind maintaining this open-source project <3

Star History Chart

Companionship and capability should never be at odds. What we aim to create is a robot that can understand emotions, provide genuine companionship, and reliably accomplish tasks.

私は、高性能ですから!

AstrBot (AstrBotDevs/AstrBot)

Searching Database…

42.1K ·GitHub
Что это такое?AstrBot — это открытая многофункциональная платформа чат-ботов на базе ИИ-агентов. Она подключает LLM к мессенджерам и соцсетям, таким как QQ, Telegram, Discord, Slack, WeChat и другим. С её помощью можно создать личного ИИ-помощника, бота для клиентской поддержки или ассистента на основе корпоративной базы знаний прямо в привычных чатах.
Это библиотека, которую я подключаю в код, или отдельный сервер, который я запускаю?Это самостоятельное приложение-сервер, которое разворачивается у вас, со своим веб-интерфейсом (WebUI). Это не библиотека. Его устанавливают через uv, Docker или десктопное приложение, и он сам подключается к выбранным мессенджерам и провайдерам LLM.
Как его запустить?Рекомендуемый быстрый способ — команда одношагового развёртывания через uv. Также можно развернуть его через Docker/Docker Compose для продакшена, использовать готовое приложение AstrBot-desktop или AstrBot Launcher для изолированных сценариев с несколькими экземплярами. Кроме того, описаны установки через панели управления (BT-Panel, 1Panel, CasaOS).
Нужно ли что-то установить перед запуском?Для способа установки через командную строку нужен uv, для контейнерного варианта — Docker/Docker Compose. Чтобы реально общаться с ботом, понадобятся учётные данные хотя бы одного провайдера LLM (OpenAI, Anthropic, Gemini, DeepSeek, Ollama и др.) и/или аккаунт или токен бота в мессенджере.
Есть ли подводные камни при установке, о которых стоит знать?На macOS первый запуск команды astrbot может занимать заметно больше времени, примерно 10–20 секунд, из-за проверок безопасности macOS. Десктопное приложение предназначено для личного использования на компьютере, а не для развёртывания на серверах.
Для кого это сделано?Это рассчитано на частных пользователей, разработчиков и команды, которые хотят использовать готовый к боевой эксплуатации диалоговый ИИ внутри мессенджеров. Это могут быть энтузиасты, которым нужен личный ИИ-помощник, или компании, которые строят автоматическую клиентскую поддержку и внутренние базы знаний.
Какие чаты и LLM он поддерживает?Интеграции с мессенджерами включают QQ, Telegram, Discord, Slack, WeChat Work/Official Accounts, Feishu, DingTalk, LINE, Matrix, Rocket.Chat и другие. В качестве бэкенда LLM поддерживаются OpenAI, Anthropic, Google Gemini, DeepSeek, Ollama, LM Studio, несколько китайских провайдеров и сервисы-шлюзы.
Можно ли всё держать у себя и не отправлять данные в облачные LLM-сервисы?Да. AstrBot поддерживает самостоятельно развёрнутые бэкенды LLM, такие как Ollama и LM Studio, наряду с облачными API. Поэтому всю систему можно запустить без передачи данных сторонним провайдерам LLM.
Что умеет AstrBot помимо базовых ответов в чате?Он поддерживает мультимодальные диалоги с LLM, вызовы навыков агентов через MCP, встроенную базу знаний, настройки персоны, автоматическое сжатие контекста и более 1000 плагинов, которые устанавливаются в один клик.
Есть ли песочница для безопасного запуска кода или команд оболочки?Да, в AstrBot есть Agent Sandbox. Это изолированная среда для безопасного выполнения кода и команд оболочки с повторным использованием ресурсов на уровне сессии.
Можно ли подключить AstrBot к готовым платформам агентов вместо прямых API LLM?Да, его можно интегрировать с платформами агентов и LLMOps, такими как Dify, Alibaba Cloud Bailian и Coze, вместо прямых вызовов API LLM или наряду с ними.
Есть ли десктопное приложение, если не хочется запускать сервер?Да, AstrBot App (AstrBot-desktop) — это готовое десктопное приложение с упором на ChatUI. Оно предназначено для личного использования, а не для развёртывания на серверах.
Size
76.5 MB
Stars
42.1K
Age
3y
Commits · 90 Days