AstrBotDevs

AstrBot: Build AI Assistants for Messaging Platforms

AstrBot is a Python-based Agent chatbot platform that connects AI conversations and tools to mainstream messaging apps. It helps individuals and teams deploy assistants in their existing chat workflows, with plugins, model integrations, and a web interface.

ActivePythonAGPL-3.0AI AgentsChatbotSelf Hosted
Stars
42.1k
Forks
3.1k
Stars, last 30 days
+4,973
Last commit
today
Contributors
100+

Our take

Activeregular commits and releases

Health score

76/100

How it is scored
Activity
90
Community
70
Issues
92
Pull requests
51

+4,973 stars in the last 30 days

  • Releases more often than 93% of the projects we track
  • Closes issues faster than 81% of the projects we track
  • More contributors than 78% of the projects we track

AstrBot is an actively maintained, broad integration platform for teams that want AI assistants in messaging workflows and can accommodate its Python and AGPL requirements.

Good fit if

  • You need one platform to connect AI assistants to several supported messaging services.
  • You want extensibility through plugins and support for multiple model and agent providers.
  • Your deployment can use Python 3.12 or newer, and you are prepared to comply with AGPL-3.0.

Look elsewhere if

  • You need a single-purpose bot for a messaging service that AstrBot does not support.
  • Your application must use a permissive license rather than AGPL-3.0.
  • You want a ready-made assistant without operating or configuring a platform and its integrations.
All health signals
Last commit2026-10-18 (today)
Commits, last 90 days100+
Releases, last 12 months100+ (latest v4.29.1, 2026-10-17)
Contributors100+ (top contributor: 69% of commits)
Issues closed, last 90 days35+ (typically closed in 0 days)
Pull requests merged, last 90 days27 (typically merged in 1 day)
Project age3 years

Checked on 2026-10-19 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

46,865

Forks

3,560

Change since Nov 13, 2026: +63 stars·+14 forks

Overview

AstrBot is a Python-based Agent chatbot platform for bringing conversational AI into instant messaging apps such as QQ, Telegram, Feishu, Slack, and Discord. It provides a shared platform for individuals, developers, and teams to build assistants that can respond and act inside the chat services they already use.

The project combines messaging adapters with LLM conversations, agents, plugins, and a WebUI. It supports multiple model services and agent platforms, so AstrBot is best understood as integration and application infrastructure rather than a chatbot tied to one model provider.

Key Features

  • Connects official adapters for a range of messaging platforms, including QQ, Telegram, Feishu, DingTalk, Slack, and Discord.
  • Supports LLM conversations, multimodal interactions, agents, MCP, skills, knowledge bases, and persona settings.
  • Integrates with model services including OpenAI-compatible APIs, Anthropic, Google Gemini, and self-hosted Ollama or LM Studio.
  • Extends functionality through plugins, with the README reporting more than 1,000 available for installation.
  • Includes a WebUI and a web ChatUI, with an agent sandbox and web search in the latter.
  • Offers a sandbox for isolating code and shell execution, with session-level resource reuse.
  • Can connect to external agent platforms such as Dify, Alibaba Cloud Bailian, and Coze.

Use Cases

  • A developer can deploy a personal assistant in a messaging app they use every day, instead of building a separate chat client.
  • A team can connect an internal knowledge-base assistant to workplace chat services such as Feishu, Slack, or DingTalk.
  • A community operator can add AI responses and plugin-driven features to a supported chat community.
  • An individual can run a self-hosted assistant backed by Ollama or LM Studio and access it through chat or the WebUI.

What you need

Detected in the repository

  • Python >=3.12 (from pyproject.toml)
  • A Dockerfile, so it can run in a container; a Compose file sets up the related services
  • A test suite and automated checks on GitHub Actions

License in plain words

AGPL-3.0network copyleft

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license notice
  • Share your changes: yes, the full source, also when people only use it over a network (e.g. as a hosted service)
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

With uv installed, initialize and run AstrBot:

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

For Docker deployment and configuration details, see the official documentation and repository README.

Alternatives

  • Hexabot: Hexabot focuses on configurable agent workflows and channels, while AstrBot connects AI assistants and tools to mainstream messaging apps.
  • core: Cheshire Cat AI is an agent framework with a local UI and REST API, while AstrBot is centered on deploying assistants in messaging apps.
ProjectLanguageLicenseStarsStatus
AstrBotPythonAGPL-3.042.1kActive
HexabotTypeScript–1.1kActive
corePythonGPL-3.03.1kActive

Considerations

  • The project has an active development and release cadence, but its wide range of messaging adapters, providers, and plugins means deployments should validate the specific integrations they rely on.
  • The required runtime is Python 3.12 or newer. Docker and Docker Compose are also supported deployment options.
  • AGPL-3.0 has obligations that teams should review, particularly when modifying or offering the software as a network service.
  • Some messaging platforms and model services may require their own accounts, credentials, or separately configured services. The README does not specify a universal setup for these dependencies.
  • WhatsApp is listed as coming soon, so it should not be treated as a currently supported official adapter.

Found this useful?

Share it with someone who would like AstrBot.

Comparisons