Skip to content

Latest commit

 

History

History
280 lines (204 loc) · 15.4 KB

README.md

File metadata and controls

280 lines (204 loc) · 15.4 KB

AstrBot-Logo-Simplified

AstrBot-miaoyimiao

⚠ 原项目（Official Upstream）：AstrBotDevs/AstrBot

当前仓库：astrbot-miaoyimiao（基于原项目二次开发，非官方主仓）。

astrbot-miaoyimiao 特有功能（相对原始仓库）

  1. 🧠 长期记忆（LTM）系统：新增 MemoryEvent/MemoryItem/Evidence 数据模型、读写策略、维护策略，以及 Dashboard 管理 API 与可视化页面。
  2. 🗂️ 项目上下文（Project Context）索引：支持源码符号检索、依赖追踪、架构摘要，以及语义索引构建与检索能力。
    • 结构化解析：Python(.py/.pyi)、JS/TS/Vue(.js/.jsx/.ts/.tsx/.vue)、Markdown/RST(.md/.rst)。
    • 依赖追踪：支持 Python 本地导入与 JS/TS/Vue 本地导入（含相对路径、@/、~/、/ 根路径写法）。
    • 路径范围：扫描根目录由索引构建参数决定，默认排除 .git、node_modules、dist、build、venv 等目录。
    • 范围查询：Dashboard 新增 GET /api/project_context/scope，可查看当前支持后缀、排除规则与已索引路径样本。
  3. 🛠️ 工程运维（Engineering Ops）中心：集成后台任务观测、工具演进策略预览/应用、编码韧性（resilience）指标与事件快照。
  4. 🔁 运行时韧性增强：增加工具循环重试、LLM 失败恢复、流式降级与上下文超限防护策略。
  5. 🧩 工作流编辑与部署：新增 Workflow 路由与前端页面，支持工作流保存、测试、多模态输入，以及部署为可用 Provider。
  6. 🔌 专业工具预设与后台任务工具：补充 MCP 专业预设与后台任务状态/列表/取消工具，提升可观测与闭环执行能力。
  7. 🖼️ Linux Desktop 截图发送可靠性增强：本地 Python 工具新增 IMAGE_DATA / ASTRBOT_IMAGE_OUTPUT 解析，避免“模型误判已发图”；同时补充截图发送闭环约束（必须收到 send_message_to_user 成功回执后才宣称已发送）。

差异基线：git diff upstream/master..master（当前分支对 AstrBotDevs/AstrBot 官方主线）。

Fork 同步记录

  • 2026-02-28：已合并 upstream/master（截至 881b409e），并保留本 fork 的冲突文件定制逻辑（agent runner / tool exec / live chat / 相关测试）。

长期记忆图谱可视化更新（Dashboard）

本仓库新增了长期记忆关系图谱视图，便于从“关系结构”而不是“表格记录”视角审查记忆状态。

  • 入口：Dashboard -> Long-term Memory -> 记忆图谱
  • 交互能力：
    • 支持按 scope / scope_id / status / predicate / min_confidence / max_relations 筛选
    • 支持节点与边点击联动，查看关系详情（subject/predicate/object、置信度、状态、关联 memory_id 等）
    • 支持谓词图例与关系密度概览，快速定位热点关系
  • 数据来源：/api/ltm/relations（图谱展示的是关系层 memory_relations，不是 memory_items 表格本身）
  • 使用说明：
    • 图谱默认主要观察 active 关系；若当前只有 shadow 记忆，图谱可能为空
    • 关系写入依赖候选事实被激活并同步为 relation；因此历史数据可能需要后续补聊或回填流程才能完全可视化

AstrBot is an open-source all-in-one Agent chatbot platform that integrates with mainstream instant messaging apps. It provides reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether you're building a personal AI companion, intelligent customer service, automation assistant, or enterprise knowledge base, AstrBot enables you to quickly build production-ready AI applications within your IM platform workflows.

screenshot_1 5x_postspark_2026-02-27_22-37-45

Key Features

  1. 💯 Free & Open Source.
  2. ✨ AI LLM Conversations, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona Settings, Auto Context Compression.
  3. 🤖 Supports integration with Dify, Alibaba Cloud Bailian, Coze, and other agent platforms.
  4. 🌐 Multi-Platform: QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack, and more.
  5. 📦 Plugin Extensions with 1000+ plugins available for one-click installation.
  6. 🛡️ Agent Sandbox for isolated, safe execution of code, shell calls, and session-level resource reuse.
  7. 💻 WebUI Support.
  8. 🌈 Web ChatUI Support with built-in agent sandbox and web search.
  9. 🌐 Internationalization (i18n) Support.

💙 Role-playing & Emotional Companionship ✨ Proactive Agent 🚀 General Agentic Capabilities 🧩 1000+ Community Plugins

99b587c5d35eea09d84f33e6cf6cfd4f

c449acd838c41d0915cc08a3824025b1

image

image

Quick Start

One-Click Deployment

uv tool install astrbot
astrbot

Requires uv to be installed.

Docker Deployment

We recommend deploying AstrBot using Docker / Docker Compose.

Please refer to the official documentation: Deploy AstrBot with Docker.

Deploy on RainYun

AstrBot has been officially listed on RainYun's cloud application platform with one-click deployment.

Deploy on RainYun

Desktop Application (Tauri)

Desktop repository: AstrBot-desktop.

Supports multiple system architectures, direct package installation, and out-of-the-box usage. A convenient one-click desktop deployment option for beginners.

One-Click Launcher Deployment (AstrBot Launcher)

A quick deployment and multi-instance solution with environment isolation. Visit the AstrBot Launcher repository and install the package for your OS from the latest release.

Deploy on Replit

Community-contributed deployment method.

Run on Repl.it

AUR

yay -S astrbot-git

More deployment methods: BT-Panel Deployment | 1Panel Deployment | CasaOS Deployment | Manual Deployment

Supported Messaging Platforms

Connect AstrBot to your favorite chat platform.

Platform Maintainer
QQ Official
OneBot v11 protocol implementation Official
Telegram Official
Wecom & Wecom AI Bot Official
WeChat Official Accounts Official
Feishu (Lark) Official
DingTalk Official
Slack Official
Discord Official
LINE Official
Satori Official
Misskey Official
WhatsApp (Coming Soon) Official
Matrix Community
KOOK Community
VoceChat Community

Supported Model Services

Service Type
OpenAI and Compatible Services LLM Services
Anthropic LLM Services
Google Gemini LLM Services
Moonshot AI LLM Services
Zhipu AI LLM Services
DeepSeek LLM Services
Ollama (Self-hosted) LLM Services
LM Studio (Self-hosted) LLM Services
CompShare LLM Services
302.AI LLM Services
TokenPony LLM Services
SiliconFlow LLM Services
PPIO Cloud LLM Services
ModelScope LLM Services
OneAPI LLM Services
Dify LLMOps Platforms
Alibaba Cloud Bailian Applications LLMOps Platforms
Coze LLMOps Platforms
OpenAI Whisper Speech-to-Text Services
SenseVoice Speech-to-Text Services
OpenAI TTS Text-to-Speech Services
Gemini TTS Text-to-Speech Services
GPT-Sovits-Inference Text-to-Speech Services
GPT-Sovits Text-to-Speech Services
FishAudio Text-to-Speech Services
Edge TTS Text-to-Speech Services
Alibaba Cloud Bailian TTS Text-to-Speech Services
Azure TTS Text-to-Speech Services
Minimax TTS Text-to-Speech Services
Volcano Engine TTS Text-to-Speech Services

❤️ Contributing

Issues and Pull Requests are always welcome! Feel free to submit your changes to this project :)

How to Contribute

You can contribute by reviewing issues or helping with pull request reviews. Any issues or PRs are welcome to encourage community participation. Of course, these are just suggestions—you can contribute in any way you like. For adding new features, please discuss through an Issue first.

Development Environment

AstrBot uses ruff for code formatting and linting.

git clone https://github.com/AstrBotDevs/AstrBot
pip install pre-commit
pre-commit install

🌍 Community

QQ Groups

  • Group 1: 322154837
  • Group 3: 630166526
  • Group 5: 822130018
  • Group 6: 753075035
  • Group 7: 743746109
  • Group 8: 1030353265
  • Developer Group: 975206796

Discord Server

Discord_community

❤️ Special Thanks

Special thanks to all Contributors and plugin developers for their contributions to AstrBot ❤️

Additionally, the birth of this project would not have been possible without the help of the following open-source projects:

⭐ Star History

Tip

If this project has helped you in your life or work, or if you're interested in its future development, please give the project a Star. It's the driving force behind maintaining this open-source project <3

Star History Chart

Companionship and capability should never be at odds. What we aim to create is a robot that can understand emotions, provide genuine companionship, and reliably accomplish tasks.

私は、高性能ですから!