Stars
Forks
Watchers
Developer links
AstrBot
Getting a language model into the chat apps people already use takes a single self-hosted server running AstrBot, which answers in QQ, Telegram, Discord, Slack, Lark, DingTalk, LINE, and WeCom. The model itself is a setting. OpenAI-compatible endpoints, Anthropic, Google Gemini, DeepSeek, Ollama, and LM Studio all work, with fallback models and retry limits for failed requests, and Dify, Coze, or Alibaba Cloud Bailian can take over a conversation too. A bare model cannot act, so the built-in agent calls MCP servers and Skills, delegates to SubAgents, runs scheduled tasks, and executes code in an isolated sandbox. It cannot read your files either, so a knowledge base takes PDF, Word, Markdown, and EPUB uploads and searches them with hybrid dense and BM25 retrieval. Personas shape each bot's personality, and Whisper or Edge TTS adds speech. When an answer looks wrong, the ChatUI shows thinking, tool calls, token counts, and latency, and a per-message trace timeline shows how the bot got there. Because the panel steers the bot, administrator IDs, session whitelists, optional TOTP login, and HTTPS protect it. Backups live under System Settings, and the plugin market installs any of more than 1,000 extensions in one click. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. AGPL-3.0 licensed.
Benefits
- One bot across many chat apps
- A single instance connects QQ, Telegram, Discord, Slack, Lark, DingTalk, LINE, KOOK, and WeCom, and conversation-to-profile bindings route each chat to its own model, persona, and settings.
- Choose any model provider
- OpenAI-compatible APIs, Anthropic, Google Gemini, DeepSeek, Ollama, and LM Studio all work, and fallback chat models with a retry limit keep replies flowing when the primary request fails.
- Give the agent tools and memory
- MCP servers, Skills, SubAgent handoff, scheduled tasks, an isolated code sandbox, and a hybrid-search knowledge base let the bot take real actions and answer from your own documents.
- Inspect every message and reply
- A trace timeline records each message, plugin call, and agent step with durations and token totals, while conversation history, statistics, and live logs show what the bot said and why.
Features
- Built-in ChatUI
- A browser chat page with profile, provider, and model selection, image, file, and voice input, visible thinking and tool calls, token and latency stats, and regeneration with another model.
- SubAgent Orchestration
- The main agent delegates tasks to named SubAgents through transfer_to delegate tools, each with its own chat provider and persona, and can hide tools that SubAgents already cover.
- Knowledge Base Retrieval
- Upload TXT, Markdown, PDF, DOCX, EPUB, and spreadsheet files up to 128 MB, chunk them at 512 characters with 50 overlap, and search with dense and BM25 retrieval.
- Message Trace Timeline
- Each message records receipt, plugin handlers, agent execution, and the response in SQLite, with filters for errors, model calls, and plugin calls and a seven-day default retention.
- Plugin Marketplace
- Install from the AstrBot plugin market or by URL or file upload, reload plugins that failed to load, and enable, disable, or rename registered commands.
- Access Control and Security
- Administrator IDs, session whitelists with blocked-message logging, optional TOTP two-factor login with recovery codes, WebUI HTTPS, and login rate limits protect the control panel.