AstrBot is an open-source agent chatbot platform that connects mainstream instant messaging platforms with large language model workflows. It supports extensibility through a plugin ecosystem and integrates with self-hosted or external model providers.
Project overview
The platform unifies fragmented instant messaging integrations and provides an agent sandbox, WebUI, and Model Context Protocol (MCP) integration.
Project type
MCP · AI Agent · Workflow
Use cases
Knowledge Q&A · Automation
Deployment
Refer to project documentation
License
AGPL-3.0
Best for
Developers and enterprise teams needing to integrate AI conversational agents across multiple instant messaging platforms.
General users who prefer managing agents via a desktop or web graphical interface.
Key capabilities
Provides AI LLM conversations, multimodal capabilities, persona settings, and auto context compression.
Implements agent capabilities, skills, and Model Context Protocol (MCP) integration.
Supports plugin extensions with 1000+ community plugins available for one-click installation.
Provides an isolated, safe environment for execution of code, shell calls, and session-level resource reuse.
Offers a Web-based user interface for managing and interacting with the bot.
Offers a built-in Web ChatUI with agent sandbox and web search.
Limitations and risks
Requires external LLM APIs or self-hosted model serving for core functionality. This means inference may require remote calls depending on the chosen model provider.
Paid services are optional but may be required depending on the selection of external LLM provider APIs.
Getting started
Setup difficulty is considered easy due to multiple one-click deployment options, AUR package availability, and Docker support.
Initialize using Python 3.12 by running 'uv tool install astrbot --python 3.12', followed by 'astrbot init' and 'astrbot run'.
Alternatives and comparisons
A self-hosted control plane to dispatch tasks, inspect runs, review failures, track spend, and coordinate agent runtimes from one local dashboard.
A self-hostable voice AI platform providing source-level control, on-premises data residency, and a workflow builder for voice agents.
A desktop app and local runtime providing a unified dashboard for managing multi-platform AI agent chats, sessions, and models.
README: 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 infrastruct…
README: AI LLM Conversations, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona Settings, Auto Context Compression.
README: uv tool install astrbot --python 3.12 astrbot init # Only execute this command for the first time to initialize the environment astrbot run
README: For users who want one-click deployment and do not want to manage servers themselves, we recommend RainYun's one-click cloud deployment service
README: For users familiar with containers and looking for a more stable, production-ready deployment method, we recommend deploying AstrBot with Docker / Docker Compose.