[opensourcedex]

AstrBot is a free, open source ai interaction & interfaces project written in Python and released under AGPL-3.0. It has 40,628 GitHub stars, 2,925 forks and 1,516 open issues, and was last pushed 9 hours ago. On this registry it ranks #11 of 76 tracked projects in AI Interaction & Interfaces, with 5 head-to-head comparisons available. It gained 83 stars over the last 3 tracked days.

What is AstrBot?

What it is

AstrBot is an open-source all-in-one Agent chatbot platform written in Python and licensed under AGPL-3.0. It integrates with mainstream instant messaging applications and provides conversational AI infrastructure for individuals, developers, and teams. The project lives in the AI and machine learning ecosystem, specifically the AI interaction and interfaces category, and it has been developed over roughly four years. Its repository carries 40,504 stars and 2,915 forks, and its documented homepage is astrbot.app. Topics attached to the project include agent, ai, chatbot, chatgpt, discord, docker, gemini, gpt, llama, llm, and mcp.

The concrete problem it solves is fragmentation. Anyone who wants an AI assistant inside a chat platform normally has to wire a language model to a specific messaging client, then repeat that work for every additional platform, model provider, and agent backend. AstrBot bundles those integrations into one deployable platform, so a personal AI companion, an intelligent customer service bot, an automation assistant, or an enterprise knowledge base can be assembled inside existing IM workflows rather than built from separate pieces. It also offers an open alternative to comparable proprietary assistants, described in the project's own tagline as being usable as an openclaw alternative.

Key capabilities

  • Conversational AI with LLM support, multimodal input, Agent behaviour, MCP, Skills, a knowledge base, persona settings, and automatic context compression.
  • Integration with external agent platforms including Dify, Alibaba Cloud Bailian, and Coze.
  • Multi-platform messaging support covering QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack, and further platforms listed in the documentation.
  • A plugin extension system with more than 1000 plugins available for one-click installation.
  • An Agent Sandbox that executes code and shell calls in isolation with session-level resource reuse.
  • WebUI support for administration, plus a Web ChatUI with a built-in agent sandbox and web search.
  • Internationalization support, with documentation and project pages published in Simplified Chinese, Traditional Chinese, Japanese, French, Spanish, and Russian.

Who uses it and how

  • Individuals run it as a personal AI companion inside a messaging platform they already use daily.
  • Teams deploy it as an intelligent customer service layer over channels such as WeChat Work, Feishu, DingTalk, or Slack.
  • Developers use it as a framework, adding capability through the plugin system instead of writing their own messaging integrations.
  • Organisations build an enterprise knowledge base on top of the knowledge base feature and persona settings.
  • Operators extend existing agent stacks by connecting Dify, Alibaba
project readme (upstream, from github) — read inline

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 Gem

readme truncated — read the full docs on github

Frequently asked questions

Is AstrBot free to use?

AstrBot is open source under the AGPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does AstrBot do?

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

What is AstrBot written in?

AstrBot is primarily written in Python. Its source is publicly available at https://github.com/AstrBotDevs/AstrBot, and it has 40,628 GitHub stars.