AstrBotDevs/AstrBot

⭐ 31,778  ·  Python  ·  GitHub Repo

AI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨

agent ai chatbot chatgpt discord docker gemini gpt

1-Sentence Summary

All-in-one open-source AI agent framework bridging LLMs with 10+ IM platforms.

🔥 Key Capabilities & USP

• Multi-Platform Unified Messaging: Integrates QQ, Telegram, Discord, WeChat Work, Feishu, DingTalk, Slack, and more. Solves the pain point of managing separate chatbots for each platform by providing a single configuration to deploy AI agents everywhere your team communicates.
• LLM & Agent Sandbox: Supports OpenAI, Gemini, Llama, GPT, and MCP protocols with an isolated execution environment for code and shell commands. Eliminates security concerns when running untrusted agent actions by sandboxing them per session.
• 1000+ Plugin Marketplace: One-click installation of community plugins for extensibility. Cuts development time from weeks to minutes by leveraging pre-built integrations for search, data analysis, and automation.
• Production-Ready WebUI & ChatUI: Built-in management dashboard and chat interface with agent sandbox and web search. Removes the need for separate frontend development—deploy and interact immediately.
• Multiple Deployment Options: Docker, uv tool, desktop app, Replit, AUR, and manual setup. Adapts to any infrastructure, from personal laptops to enterprise clusters.

USP: AstrBot is the only free, open-source framework that combines 10+ IM integrations, LLM orchestration, an agent sandbox, and a plugin marketplace in one cohesive package—no vendor lock-in, no per-seat fees.

Technical Architecture

Component	Technology / Approach
Language	Python 3.10+ (recommended 3.12)
Package Management	uv tool for fast, reproducible installs
Deployment	Docker/Docker Compose, desktop app, AUR, Replit, manual
LLM Integration	OpenAI, Gemini, Llama, GPT, MCP protocol
Agent Platform Bridges	Dify, Alibaba Cloud Bailian, Coze
Messaging Adapters	QQ, Telegram, Discord, WeChat Work, Feishu, DingTalk, Slack
Plugin System	Marketplace with 1000+ community plugins, one-click install
Security	Agent sandbox with isolated code/shell execution
Internationalization	i18n with multiple language READMEs

Quick Start Guide

Install via uv (recommended):

uv tool install astrbot --python 3.12
astrbot init
astrbot run

Upgrade:

uv tool upgrade astrbot --python 3.12

Install via AUR (Arch Linux):

yay -S astrbot-git

Alternative: Use Docker Compose or the desktop app launcher for GUI-based setup.

Pros, Cons & Use Cases

Pros

• Zero cost: Fully open-source with no paid tiers or feature gates.
• Extreme flexibility: Supports 10+ IM platforms, multiple LLM providers, and 1000+ plugins.
• Safe agent execution: Sandboxed environment prevents malicious code from affecting the host.
• Rapid deployment: One-command install and WebUI management reduce operational overhead.
• Active community: 31,778 stars indicate strong adoption and ongoing development.

Cons

• Python 3.10+ required: Older systems may need an upgrade.
• WebUI upgrade limitation: uv-deployed version cannot upgrade through the WebUI—must use CLI.
• macOS first-run delay: Security checks cause a 10-20 second startup on initial launch.
• Plugin quality variance: With 1000+ community plugins, quality and maintenance levels vary.

Who should NOT use this?

• Teams needing enterprise SLA support: No commercial backing or guaranteed uptime.
• Non-technical users without CLI comfort: While WebUI helps, initial setup requires terminal commands.
• Projects requiring a single, fixed chatbot: The flexibility of multi-platform support adds complexity if you only need one channel.
• Security-averse environments: Sandboxing exists but community plugins may introduce risks.

Ideal Use Cases

• Personal AI companion: Deploy a private assistant across Telegram, Discord, and QQ simultaneously.
• Enterprise customer service: Integrate with WeChat Work, Feishu, or DingTalk for intelligent ticket handling and knowledge base queries.
• Developer automation: Use the agent sandbox to run code generation, testing, or deployment scripts from chat.
• Community management: Moderate and assist users across Discord, Telegram, and QQ with a single AI backend.
• Research & prototyping: Quickly test LLM integrations and agent workflows without building infrastructure from scratch.

Community & Activity

AstrBot is on a meteoric trajectory with 31,778 stars—a clear signal of strong community validation and real-world adoption. The project is actively maintained, with the latest update on May 10, 2026, demonstrating ongoing feature development and bug fixes. The combination of a thriving plugin marketplace (1000+ plugins), multi-language support, and frequent releases makes this a highly recommended choice for anyone looking to build AI agents without reinventing the wheel. The momentum suggests rapid growth ahead—jump in now while the ecosystem is still expanding.