AstrBotDevs/AstrBotPublic

What is AstrBot?

A multi-platform AI chatbot framework supporting QQ, WeChat, and Telegram with rich plugin capabilities.

What does AstrBot do?

AstrBot is a flexible conversational AI framework designed to connect large language models to various instant messaging platforms. It acts as a bridge between LLM providers (like OpenAI, Claude, or local models) and social networks including QQ, WeChat, Telegram, and Discord. The framework supports a robust plugin ecosystem, allowing developers to extend bot functionality with features like web search, image generation, or custom API integrations. It emphasizes ease of deployment and extensive configuration options for community management and personal assistance. Its extensible architecture supports numerous plugins, allowing developers to customize responses and capabilities easily across IM platforms.

Who is AstrBot for?

Community managers, developers, and tech enthusiasts who want to deploy capable AI assistants on popular messaging platforms.

How do I get started with AstrBot?

docker pull astrbotdevs/astrbot && docker run -d -p 6180:6180 astrbotdevs/astrbot

How popular is AstrBot on GitHub?

AstrBotDevs/AstrBot has 41,344 stars and 3,014 forks on GitHub, and gained 371 stars in the last 7 days.

What license does AstrBot use?

AstrBotDevs/AstrBot is released under the AGPL-3.0 license.

• Widely adopted

  41,344 stars

• Very active

  2,134 commits in 52 weeks

• Community-driven

  ~377 contributors

• Continuous integration

  Automated checks passing

• Repeat trending

  3 trending appearances

AstrBot is a flexible conversational AI framework designed to connect large language models to various instant messaging platforms. It acts as a bridge between LLM providers (like OpenAI, Claude, or local models) and social networks including QQ, WeChat, Telegram, and Discord. The framework supports a robust plugin ecosystem, allowing developers to extend bot functionality with features like web search, image generation, or custom API integrations. It emphasizes ease of deployment and extensive configuration options for community management and personal assistance. Its extensible architecture supports numerous plugins, allowing developers to customize responses and capabilities easily across IM platforms.

Community managers, developers, and tech enthusiasts who want to deploy capable AI assistants on popular messaging platforms.

• Multi-Platform Support: Connects seamlessly to QQ, WeChat, Telegram, Discord, and other messaging networks.
• LLM Integration: Supports various AI models including OpenAI, Claude, Gemini, and local deployments.
• Plugin Architecture: Extensible system for adding custom commands, tools, and automated behaviors.
• Visual Configuration: Provides a web-based dashboard for easy management of bot settings and active plugins.
• Docker Deployment: Offers simple containerized deployment options for quick setup and scaling.
• IM Compatibility: Natively hooks into major instant messaging platforms for seamless bot deployment.

Getting started: docker pull astrbotdevs/astrbot && docker run -d -p 6180:6180 astrbotdevs/astrbot

1. v4.28.2v4.28.2Sep 27, 2026509 downloads

   ## [4.28.2] - 2026-09-27 ### Fixes - Fixed SQLite datetime fields being inferred as SQLModel `UTCDateTime` after dependency upgrades, which caused knowledge-base writes, dashboard statistics, and related database operations to fail for naive datetime values. (#10205, #10212, #10255) - Fixed platform message-history cleanup using a local-time cutoff instead of UTC, which could leave records undeleted on hosts outside UTC. (#10255) ## 中文 ### 修复 - 修复 SQLModel 依赖升级后 SQLite 时间字段被推断为 `UTCDateTime`，导致知识库写入、Dashboard 统计及相关数据库操作因 naive datetime 失败的问题。 (#10205, #10212, #10255) - 修复平台消息历史清理使用本地时间计算截止时间的问题，避免非 UTC 主机上出现消息未被删除的情况。 (#10255) [4.28.2]: https://github.com/AstrBotDevs/AstrBot/compare/v4.28.1...v4.28.2

2. v4.28.1v4.28.1Sep 14, 20261.8K downloads

   ## [4.28.1] - 2026-09-14 We live in stories we collectively believe in. 我们活在共同相信的故事里。 ### Additions and Optimizations - Added paginated ChatUI history loading and improved chat settings, the message composer, and streaming interactions. Reasoning is now displayed by default, and workspace code previews use Shiki highlighting. (#9667, #10021, #10020, #10023) - Added provider source filters and sticky group headers to model selection, and improved provider configuration dialogs. (#10084, #10007) - Added adaptive input image processing for the built-in Agent: resize or convert images when needed and turn animated images into frame montages. Preserve static image dimensions in CUA sandboxes and warn when images may exceed provider upload limits. (#9703, #10071) - Unified `/new` and `/reset` to start a new conversation, with permissions configurable in command management. (#10004) - Added desktop update download progress and reduced bundled WebUI font and diagram assets. (#10050, #10034) - Improved configuration slider robustness. (#10037) - Standardized provider request User-Agent headers to include the AstrBot version. (#10082) ### Fixes - ‼️ Preserved original

3. v4.28.0v4.28.0Sep 7, 2026842 downloads

   ## [4.28.0] - 2026-09-08 四时之景不同，而乐亦无穷也。 Each season brings its own beauty, and the joy is endless. > 📢 由于配置文件部分结构优化，升级后再降级将导致部分配置内容重置，升级后请谨慎降级。 > Due to structural optimizations in the configuration file, downgrading after an upgrade will result in the reset of some configuration content. Please be cautious when downgrading after an upgrade. ### Major Additions - Redesigned the WebUI pages for model providers, bots, and profiles, and consolidated logs, traces, conversation management, and data into the **Data & Logs** page. Removed the **Agent Runner** from model providers and embedded its settings into each profile. (#9820, #9825, #9821, #9883, #9846) - Redesigned the default and local T2I rendering. (#9803) - Enriched unified group metadata across messaging platform adapters. (#9851) - Automatically record readable names for unified message origins (UMOs), such as group and user names, making them easier to find in the WebUI. (#9909) - Added masked secret fields for sensitive values in the WebUI and plugin configurations. (#9824) - Added batch deletion to the WebUI skill management page. (#9906) - Added AnySearch as a built-in web search provider. (#9767)

4. v4.28.0-beta.1v4.28.0-beta.1Sep 1, 2026493 downloads

   ## [4.28.0-beta.1] - 2026-09-02 > ### Major Additions - Redesigned the WebUI pages for model providers, bots, and profiles, and consolidated logs, traces, conversation management, and data into the **Data & Logs** page. Removed the **Agent Runner** from model providers and embedded its settings into each profile. (#9820, #9825, #9821, #9883, #9846) - Redesigned the default and local T2I rendering. (#9803) - Enriched unified group metadata across messaging platform adapters. (#9851) - Automatically record readable names for unified message origins (UMOs), such as group and user names, making them easier to find in the WebUI. (#9909) - Added masked secret fields for sensitive values in the WebUI and plugin configurations. (#9824) - Added batch deletion to the WebUI skill management page. (#9906) - Added AnySearch as a built-in web search provider. (#9767) - Added support for password-style plugin configuration fields and masked sensitive profile fields by default. (#9824) ### Major Optimizations - Improved how browser password managers recognize the WebUI login page. (#9830) - Adapted model provider icons for dark mode. (#9647) - Improved context handling for

5. v4.27.5v4.27.5Aug 31, 2026373 downloads

   ## [4.27.5] - 2026-09-01 ### Fixed - Fixed an issue where the initial random password was not displayed when running `astrbot run` for the first time. (#9879) Tips: You can also use `astrbot password` to change the password. ## 中文 ### 修复 - 修复了首次执行 `astrbot run` 时未显示初始随机密码的问题。(#9879) Tips: 也可以使用 `astrbot password` 修改密码。 [4.27.5]: https://github.com/AstrBotDevs/AstrBot/compare/v4.27.4...v4.27.5

• public-apis/public-apis

  A collective list of free APIs

  486.1K stars · Python

• openclaw/openclaw

  The AI that really does things. Any OS. Any Platform. The lobster way. 🦞

  391.3K stars · TypeScript

• donnemartin/system-design-primer

  Learn how to design large-scale systems. Prep for the system design interview. Includes Anki flashcards.

  373.2K stars · Python

• obra/superpowers

  An agentic skills framework & software development methodology that works.

  295.2K stars · Shell

• practical-tutorials/project-based-learning

  Curated list of project-based tutorials

  285.8K stars · Python

• affaan-m/ECC

  The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

  272.8K stars · JavaScript