中文 ｜ 繁體中文 ｜ 日本語 ｜ Français ｜ Русский

Home ｜ Docs ｜ Blog ｜ Roadmap ｜ Issue Tracker ｜ Email Support

AstrBot is an open-source, all-in-one Agentic personal and group chat assistant that can be deployed on dozens of mainstream instant messaging platforms such as QQ, Telegram, WeCom, Lark, DingTalk, Slack, and more. It also features a built-in lightweight ChatUI similar to OpenWebUI, creating a reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether it's a personal AI companion, smart customer service, automated assistant, or enterprise knowledge base, AstrBot enables you to quickly build AI applications within the workflow of your instant messaging platforms.

1. 💯 Free & Open Source.
2. ✨ Large Language Model (LLM) dialogue, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona settings, automatic dialogue compression.
3. 🤖 Supports integration with agent platforms such as Dify, Alibaba Bailian, Coze, etc.
4. 🌐 Multi-platform support: QQ, WeCom, Lark, DingTalk, WeChat Official Account, Telegram, Slack, and more.
5. 📦 Plugin extension: 1000+ plugins available for one-click installation.
6. 🛡️ Agent Sandbox: Isolated environment for safely executing any code, calling Shell commands, and reusing session-level resources.
7. 💻 WebUI support.
8. 🌈 Web ChatUI support: Built-in proxy sandbox, web search, etc. within ChatUI.
9. 🌐 Internationalization (i18n) support.

For users who want to experience AstrBot quickly, are familiar with the command line, and can install the uv environment themselves, we recommend using uv for one-click deployment ⚡️.

uv tool install astrbot astrbot init # Execute this command only for the first time to initialize the environment astrbot run # astrbot run --backend-only starts only the backend service # Install development version (more fixes and new features, but less stable; suitable for developers) uv tool install git+https://github.com/AstrBotDevs/AstrBot@dev

Requires uv installed.

Update astrbot:

uv tool upgrade astrbot

For users familiar with containers who prefer a more stable deployment suitable for production environments, we recommend using Docker / Docker Compose to deploy AstrBot.

Please refer to the official documentation Deploy AstrBot with Docker.

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

For users who wish to use AstrBot on the desktop with ChatUI as the main interface, we recommend using the AstrBot App.

Go to AstrBot-desktop to download and install; this method is intended for desktop use and is not recommended for server scenarios.

Also for desktop, users who want quick deployment and isolated environments for multiple instances can use the AstrBot Launcher.

Go to AstrBot Launcher to download and install.

Replit deployment is maintained by the community, suitable for online demos and lightweight trials.

The AUR method is for Arch Linux users who wish to install AstrBot via the system package manager.

Execute the following command in the terminal to install the astrbot-git package. You can start using it after installation completes.

yay -S astrbot-git

More Deployment Methods

If you need panel-based or highly customized deployment, you can refer to BT Panel (BT Panel App Store), 1Panel (1Panel App Store), CasaOS (NAS / Home Server visual deployment), and Manual Deployment (Full custom installation based on source code and uv).

Connect AstrBot to your favorite chat platforms.

Welcome any Issues/Pull Requests! Just submit your changes to this project :)

You can contribute by viewing issues or helping to review PRs (Pull Requests). Any issues or PRs are welcome to promote community contribution. Of course, these are just suggestions; you can contribute in any way. For new feature additions, please discuss via Issue first. It is recommended to merge functional PRs into the dev branch, which will be merged into the main branch and released as a new version after testing. To reduce conflicts, we suggest:

1. Create your working branch based on the dev branch, avoid working directly on the main branch.
2. When submitting a PR, select the dev branch as the target.
3. Regularly sync the dev branch to your local environment; use git pull frequently.

AstrBot uses ruff for code formatting and checking.

git clone https://github.com/AstrBotDevs/AstrBot git switch dev # Switch to dev branch pip install pre-commit # or uv tool install pre-commit pre-commit install

We recommend using uv for local installation and testing:

uv tool install -e . --force astrbot init astrbot run

Frontend Debugging:

astrbot run --backend-only cd dashboard bun install # or pnpm, etc. bun dev

• Group 9: 1076659624 (New)
• Group 10: 1078079676 (New)
• Group 1: 322154837
• Group 3: 630166526
• Group 5: 822130018
• Group 6: 753075035
• Group 7: 743746109
• Group 8: 1030353265
• Developer Group (Casual): 975206796
• Developer Group (Official): 1039761811

• Discord

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

In addition, the birth of this project cannot be separated from the help of the following open-source projects:

• NapNeko/NapCatQQ - Great Cat Framework

Open Source Project Friendly Links:

• NoneBot2 - Excellent Python Asynchronous ChatBot Framework
• Koishi - Excellent Node.js ChatBot Framework
• MaiBot - Excellent Anthropomorphic AI ChatBot
• nekro-agent - Excellent Agent ChatBot
• LangBot - Excellent Multi-platform AI ChatBot
• ChatLuna - Excellent Multi-platform AI ChatBot Koishi Plugin
• Operit AI - Excellent AI Assistant Android APP

Companionship and capability should never be opposites. We hope to create a robot that can both understand emotions, provide companionship, and reliably complete tasks.

私は、高性能ですから!