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

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.

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.

💙 Role-playing & Emotional Companionship	✨ Proactive Agent	🚀 General Agentic Capabilities	🧩 1000+ Community Plugins

Quick Start

One-Click Deployment

For users who want to quickly experience AstrBot, we recommend using the one-click deployment method with uv ⚡️:

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

Requires uv to be installed.

Docker Deployment

For users who want a more stable and production-ready deployment, we recommend using Docker / Docker Compose to deploy AstrBot.

Please refer to the official documentation: Deploy AstrBot with Docker.

Deploy on RainYun

For users who want to deploy AstrBot with one-click and don't want to manage the server, we recommend using RainYun's one-click cloud deployment service ☁️:

Desktop Application (Tauri)

For users who want to deploy AstrBot on their desktop, primarily using AstrBot ChatUI, rarely use AstrBot plugins, we recommend using the AstrBot App:

Desktop repository: AstrBot-desktop.

Supports multiple system architectures, direct package installation, and out-of-the-box usage. A convenient one-click desktop deployment option for beginners.

One-Click Launcher Deployment (AstrBot Launcher)

For users who want a quick deployment and multi-instance solution with environment isolation, we recommend using the AstrBot Launcher:

Visit the AstrBot Launcher repository and install the package for your OS from the latest release.

A quick deployment and multi-instance solution with environment isolation.

Deploy on Replit

Community-contributed deployment method.

AUR

yay -S astrbot-git

More deployment methods: BT-Panel Deployment | 1Panel Deployment | CasaOS Deployment | Manual Deployment

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
Misskey	Official
WhatsApp (Coming Soon)	Official
Matrix	Community
KOOK	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
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
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
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

• Group 1: 322154837
• Group 3: 630166526
• Group 5: 822130018
• Group 6: 753075035
• Group 7: 743746109
• Group 8: 1030353265
• Developer Group: 975206796

Discord Server

❤️ Special Thanks

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

Additionally, the birth of this project would not have been possible without the help of the following open-source projects:

• NapNeko/NapCatQQ - The amazing cat framework

⭐ 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

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.

私は、高性能ですから!