Repolode
Submit
AstrBotDevs

AstrBotDevs/AstrBot

Open-source agent chatbot platform that connects LLMs, plugins and agent tools to IM apps like QQ, Telegram, Slack and Discord.

View on GitHubWebsite
Stars
42,354
Forks
3,103
Open issues
966
Last commit
11 hours ago

What is it?

AstrBot is an open-source, all-in-one agent chatbot platform that connects large language models to mainstream instant messaging apps. It is aimed at individuals, developers and teams who want to run personal assistants, customer service bots, automation helpers or internal knowledge-base bots inside the chat tools they already use.

The project supports a wide range of messaging platforms, including QQ, WeChat Work, Feishu, DingTalk, Telegram, Slack, Discord and LINE, along with many model services such as OpenAI-compatible APIs, Anthropic, Google Gemini, DeepSeek and local Ollama. It also covers agent features like MCP, knowledge bases, persona settings, context compression, and an agent sandbox for isolated code and shell execution. A plugin system and a WebUI are included for management.

Deployment options include a uv-based command-line install, Docker and Docker Compose, and a desktop app, so it can run on a personal machine or a server.

Key features

  • 01Connects to QQ, Telegram, Slack, Discord, Feishu, DingTalk and other messaging platforms.
  • 02Supports multiple LLM providers, including OpenAI-compatible APIs, Anthropic, Gemini and Ollama.
  • 03Includes MCP support, knowledge bases, persona settings and automatic context compression.
  • 04Provides an agent sandbox for isolated code and shell execution.
  • 05Offers a plugin system with a marketplace and a WebUI for management.

Use cases

  • Running a personal AI companion inside QQ or Telegram.
  • Building a customer service bot for a team's messaging platform.
  • Answering questions from an internal knowledge base within chat apps.
  • Automating routine tasks through agent tools and plugins.

Quick start

  1. 1

    Install uv (prerequisite)

  2. 2

    Install AstrBot with uv

    uv tool install astrbot --python 3.12
  3. 3

    Initialize the environment (first time only)

    astrbot init
  4. 4

    Start AstrBot

    astrbot run

Things to know

  • Requires a Python 3.12+ environment and uv for the quick install.
  • Connecting LLMs and most IM platforms needs your own API keys or platform accounts.
  • Dependent on third-party messaging platform and model service availability.

Topics

#agent#chatbot#llm#mcp#im-bot#qq-bot#telegram-bot#python#ai#astrbot

FAQ

What is AstrBot?
Open-source agent chatbot platform that connects LLMs, plugins and agent tools to IM apps like QQ, Telegram, Slack and Discord. AstrBot is an open-source, all-in-one agent chatbot platform that connects large language models to mainstream instant messaging apps. It is aimed at individuals, developers and teams who want to run personal assistants, customer service bots, automation helpers or internal knowledge-base bots inside the chat tools they already use.
Is AstrBot free to use? What license does it have?
AstrBot is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is AstrBot still maintained?
Actively maintained. The last commit to AstrBot was on Oct 20, 2026.
What can I use AstrBot for?
Running a personal AI companion inside QQ or Telegram. Building a customer service bot for a team's messaging platform. Answering questions from an internal knowledge base within chat apps. Automating routine tasks through agent tools and plugins.
How do I install AstrBot?
Install uv (prerequisite) Install AstrBot with uv: uv tool install astrbot --python 3.12 Initialize the environment (first time only): astrbot init Start AstrBot: astrbot run
Where can I get AstrBot?
The source code and installation instructions are on GitHub: https://github.com/AstrBotDevs/AstrBot

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects