🧠
四层记忆模型
工作记忆 · 事实记忆 · 情景记忆 · 语义记忆，像人一样，记住你说过的每一件事
🌸 YuanBot不是工具，是陪伴
有记忆、有情感、会主动想起你的开源 AI 虚拟伴侣
Skip to content
🚀 快速安装
源码安装
bash
git clone https://github.com/Grabrun/YuanBot.git
cd YuanBot
python3 -m venv .venv
source .venv/bin/activate
pip install -e "."
pip install -e ".[cli,openai]" # 可选扩展
yuanbot startpowershell
git clone https://github.com/Grabrun/YuanBot.git
cd YuanBot
python -m venv .venv
.venv\Scripts\activate
pip install -e "."
pip install -e ".[cli,openai]" # 可选扩展
yuanbot startDocker 安装
bash
git clone https://github.com/Grabrun/YuanBot.git
cd YuanBot
cp .env.example .env
# 编辑 .env，填入你的 API Key
docker-compose up -d首次启动后访问 http://localhost:8000 进入 WebUI，或运行 yuanbot tui 进入终端界面。
📊 项目数据
- 10 大核心系统 — 覆盖记忆、情感、通信、AI、TUI、WebUI 等全链路
- 100+ 个源代码文件 — 高内聚、低耦合的模块化架构
- 1453 个测试全部通过 — 99% 设计文档符合度
- 10 种消息通道 — 涵盖主流 IM 平台，频道适配器 API 文档开源参考
- CI/CD 自动化 — GitHub Actions 持续集成与部署
🏗️ 技术栈
| 领域 | 技术 |
|---|---|
| 后端 | Python 3.12+ · FastAPI + WebSocket · structlog · Prometheus |
| 前端 | Vue 3 + Naive UI · Textual (TUI) |
| 数据 | SQLite + MySQL · Milvus Lite 向量数据库 · Kuzu 图数据库 · Redis 缓存 |
| 基础设施 | WASM / Docker / gRPC 三沙盒 · GitHub Actions CI/CD |
🧠 存储架构
| 引擎 | 用途 |
|---|---|
| SQLite + FTS5 | 结构化数据 + 全文检索 |
| MySQL | 生产级关系型存储 |
| Milvus Lite | 向量数据库，语义检索 |
| Kuzu | 图数据库，关系推理 |
© 2026 YuanBot · Made with 🌸 by Grabrun