# multi-agent-study-assistant

**Repository Path**: zrt-cmd/multi-agent-study-assistant

## Basic Information

- **Project Name**: multi-agent-study-assistant
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-29
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📚 星学伴 AI-Tutor-Hub — 多智能体 AI 学习助手

基于 FastAPI + React + LangGraph 的多智能体 AI 学习平台。9 个专业化 Agent 协同工作，主 Agent 动态路由，提供个性化学习路线、互动测验、AI 导师、思维导图、代码练习及文档 RAG 问答。

## 🌟 功能特性

- **个性化学习分析**：11 维学生画像，AI 诊断知识盲区
- **智能学习路线**：10 阶段 Python 知识体系，自适应跳过/放慢
- **互动测验**：选择/判断/简答，自动评分 + 详细解析
- **AI 导师**：苏格拉底式 24/7 答疑，流式 SSE 输出
- **思维导图**：ECharts 树图可视化，分支彩色标注
- **代码实操**：由浅入深编程练习，完整可运行
- **文档问答（RAG）**：上传 PDF/TXT，ChromaDB 检索 + BGE-M3 嵌入
- **资源搜索**：DuckDuckGo 实时搜索 + 预设精选库
- **语音交互**：讯飞 ASR/TTS 语音识别与合成
- **统一对话**：主 Agent 意图分类，自然语言触发任意功能

## 🏗️ 架构

| 层 | 技术栈 |
|------|------|
| **前端** | React 18 + TypeScript + Vite + Tailwind CSS v4 + shadcn/ui |
| **后端** | FastAPI + Uvicorn + Pydantic v2（异步 ASGI） |
| **多智能体** | Phidata 9 Agent + LangGraph 主 Agent 协调 |
| **数据库** | PostgreSQL（7 表）+ Redis（缓存/会话/消息队列） |
| **向量库** | ChromaDB + BGE-M3 嵌入 |
| **异步任务** | Celery Worker（文档处理） |
| **流式通信** | SSE（Server-Sent Events） |
| **语音** | 讯飞星火 ASR/TTS |
| **部署** | Docker Compose（PostgreSQL + Redis + FastAPI + Celery + Nginx） |

## 🚀 快速开始

```bash
# 终端 1：后端
cd AI-Tutor-Hub
.venv/bin/uvicorn backend.main:app --reload --port 8000

# 终端 2：Celery Worker
cd AI-Tutor-Hub
.venv/bin/celery -A backend.celery_app worker --loglevel=info

# 终端 3：前端
cd AI-Tutor-Hub/frontend
npm install
npx vite --host
```

浏览器打开 `http://localhost:5173`

## Docker 部署

```bash
docker compose up -d
# 前端 → localhost:80
# 后端 → localhost:8000
```

## 9 个专业 Agent

| # | Agent | 职责 | 协作方式 |
|---|-------|------|----------|
| ① | student_analyzer | 诊断学生水平，找知识缺口 | 全流程生成 |
| ② | roadmap_creator | 制定 10 阶段 Python 学习路线 | 全流程生成 |
| ③ | quiz_generator | 生成选择/判断/简答题 | 主Agent 路由 |
| ④ | tutor_agent | 苏格拉底式答疑，流式输出 | 主Agent 路由 |
| ⑤ | resource_finder | 筛选推荐学习资源 | 全流程生成 |
| ⑥ | rag_tutor_agent | 基于上传文档的 RAG 问答 | 独立 |
| ⑦ | profile_extractor | 自然语言提取 11 维画像 | 独立 |
| ⑧ | mindmap_creator | 生成 Markdown 知识导图 | 主Agent 路由 |
| ⑨ | code_practice | 生成编程实操题 | 主Agent 路由 |

## 🎯 使用流程

1. 首页 → 填写 11 维学习画像 → AI 生成学习计划
2. 进入 Dashboard → 学习资料（路线+资源） / 学习工具（导图+代码+测验） / AI 助手
3. AI 助手中一句话触发：出题、导图、代码、答疑、找资源

## 📄 许可证

开源，仅供教育目的使用。中国软件杯 A3 赛题。