█

AI/TLDR

AstrBot

All-in-one agent chatbot platform for your messaging apps

github.com/AstrBotDevs/AstrBot★ 39.6kastrbot.app

Overview

AstrBot is an open-source all-in-one agent chatbot platform that integrates with mainstream instant-messaging apps. Instead of giving you a standalone chat window, it puts a configurable AI agent inside the chat services your users already live in, and provides the surrounding infrastructure — model routing, conversation state, permissions and a web control panel — so a bot can run reliably rather than as a one-off script.

The bot itself is more than a passthrough to a model. It handles multimodal conversations, tool and MCP calls, skills, knowledge bases, persona settings and automatic context compression, and it can also delegate to external agent platforms such as Dify, Alibaba Cloud Bailian and Coze. An agent sandbox isolates code execution and shell calls, and lets a session reuse resources safely across turns.

AstrBot is written in Python and ships a WebUI for configuration plus a web ChatUI with a built-in agent sandbox and web search. Extensions come from a plugin marketplace with over a thousand one-click installable plugins, and the project is internationalised. It is released under the AGPL-3.0 licence.

What it does

  • Connects one agent to many messaging platforms — Telegram, Slack, Discord, QQ, WeCom, WeChat Official Accounts, Feishu (Lark), DingTalk, LINE, KOOK, Misskey, Mattermost and OneBot v11
  • LLM conversations with multimodal input, agent behaviour, MCP and tool calls, skills, knowledge bases, persona settings and automatic context compression
  • Agent sandbox that isolates code execution and shell calls and reuses resources at the session level
  • Plugin marketplace with 1000+ plugins installable in one click
  • WebUI for administration plus a web ChatUI with built-in sandbox and web search
  • Works with OpenAI-compatible services, Anthropic and Google Gemini, and can hand off to agent platforms like Dify, Bailian and Coze

Getting started

The project's own quick start offers a one-command install via uv, a Docker deployment for production, and desktop builds. The commands below are the uv path from the README; it needs uv installed and Python 3.12.

Install AstrBot with uv

Install the CLI as a uv tool pinned to Python 3.12. On macOS the first run of the astrbot command can take 10-20 seconds because of security checks.

bashbash
uv tool install astrbot --python 3.12

Initialise the environment and run

Run init once to set up the environment, then start the bot. The WebUI comes up with it, and that is where you connect messaging platforms, pick model providers and install plugins.

bashbash
astrbot init  # only needed the first time
astrbot run

Keep it up to date

Upgrade the installed tool in place when a new release lands.

bashbash
uv tool upgrade astrbot --python 3.12

Deploy with Docker instead

For a more stable, production-oriented deployment the project recommends Docker or Docker Compose; the official image is published as soulter/astrbot and the deployment guide lives in the docs.

texttext
https://docs.astrbot.app/deploy/astrbot/docker.html

Commands and code are distilled from the project's own documentation — always check the official repo for the latest.

When to use it

  • Run a shared AI assistant inside a team's Slack, Discord, Feishu or DingTalk workspace without building the platform plumbing yourself
  • Stand up intelligent customer service or an enterprise knowledge-base bot on the messaging channel your customers already use
  • Give a personal AI companion a persistent home in a chat app, with persona settings and long-running conversation context
  • Extend a chatbot with tools, MCP servers and marketplace plugins instead of writing bespoke integrations per platform

How AstrBot compares

AstrBot alongside other open-source assistants & chatbots tools AI/TLDR tracks, ranked by GitHub stars.

ToolStarsWhat it does
OpenClaw★ 388kOpenClaw is a self-hosted personal AI assistant that answers you on WhatsApp, Telegram, Slack, Discord, and many other channels, with voice and a live visual canvas.
Hermes Agent★ 237kA self-improving personal AI agent from Nous Research that builds skills from experience, remembers across sessions, and reaches you on Telegram, Discord, Slack, and more.
AstrBot★ 39.6kAll-in-one agent chatbot platform for your messaging apps
Khoj★ 36.7kAn open-source, self-hostable personal AI that chats with any local or online LLM, answers from your own documents and the web, and runs custom agents.
AgenticSeek★ 27kAn open-source, 100% local alternative to Manus AI that autonomously browses the web, writes code, and plans tasks while keeping all your data on your machine.
Leon★ 17.5kLeon is an open-source personal AI assistant that uses real tools, layered memory, and agent-style planning to complete tasks across local and remote AI providers.
Rowboat★ 17.4kRowboat connects to your email and meeting notes, builds a long-lived knowledge graph on your machine, and uses that context to draft, summarize, and plan.
Eigent★ 15.1kEigent is an open-source Cowork desktop that builds a custom AI workforce of specialized agents to break down and automate complex tasks on your machine.