DeepTutor:原生智能体驱动的个性化学习助手
DeepTutor是一个基于原生智能体架构的个性化AI学习助手,它利用大语言模型和多智能体系统技术,为用户提供灵活、深度的交互式学习体验。该项目采用两层插件模型,核心功能包括智能辅导机器人、命令行工具以及支持检索增强生成(RAG)的知识库系统,能够根据用户的学习进度和需求动态调整教学内容和方式。DeepTutor支持多种学习模式切换,具备持续的会话记忆能力,并可处理包括文档上传在内的多种知识源,适用于自主学习、技能培训、研究辅助等场景。其设计兼顾了开发者与普通用户,既提供了可编程的SDK接口,也提供了开箱即用的交互界面,旨在通过AI技术实现高效、个性化的知识传递与能力培养。
💡 应用场景
DeepTutor最适合需要个性化、多模式、可扩展的AI学习助手场景,尤其适用于自主学习、企业培训和研究辅助,兼顾终端用户和开发者需求。
个性化学习辅导
问题:传统AI助教只能回答固定问题,无法根据学生进度动态调整教学内容和方式。
方案:DeepTutor利用多智能体系统和会话记忆,能跟踪学习进度,自动切换深度解答、测验生成、深度研究等模式,提供持续适应的学习路径。
示例:学生先提问一个数学题,DeepTutor给出详细解答后,自动生成相关测验,再深入推荐扩展资料,全程保持上下文连贯。
文档驱动的知识问答
问题:需要从大量文档(如PDF、Markdown)中快速提取信息并回答专业问题,但手动检索效率低。
方案:通过RAG知识库系统上传文档,DeepTutor自动索引并支持基于文档的问答,结合多轮对话精准定位答案。
示例:上传公司内部技术手册后,开发者直接问“如何配置数据库连接池”,DeepTutor从手册中提取相关章节并给出步骤。
命令行智能助手
问题:开发者在终端中需要快速获取代码建议、调试帮助或执行复杂任务,但缺乏上下文感知的交互工具。
方案:DeepTutor提供CLI工具,可在终端中直接启动智能对话,支持代码补全、错误排查和任务自动化,无需切换界面。
示例:在终端输入`tutor debug`并粘贴报错日志,DeepTutor自动分析错误原因并给出修复建议。
多通道机器人教学
问题:需要在不同平台(如Discord、Web)上提供统一的教学服务,但各平台独立开发成本高。
方案:TutorBot支持多通道部署,每个机器人拥有独立记忆和技能集,可在不同平台间同步学习进度和个性化设置。
示例:学生在Discord上提问,TutorBot记录学习状态;之后在Web端继续学习时,系统自动恢复上次对话和测验结果。
📊 项目信息
- 语言
- Python
- Stars
- ⭐ 26,237
- Forks
- 3,561
- 今日新增
- +172
- 排名
- #8
- 收录
- 总榜
- 趋势日期
- 2026年7月15日
- 最后推送
- 2026/7/9
🏷️ 标签
5分钟快速开始DeepTutor
DeepTutor是一个原生智能体驱动的个性化学习助手,通过AI代理提供交互式学习体验。
🖥️ 操作系统
⚙️ 运行环境
🔧 工具
📝 操作步骤
克隆项目并进入目录
从GitHub克隆DeepTutor仓库到本地。
克隆项目
$ git clone https://github.com/HKUDS/DeepTutor.git进入项目目录
$ cd DeepTutor运行设置向导(推荐)
使用交互式脚本自动安装依赖和配置环境。
启动设置向导
$ python scripts/setup_tour.py配置API密钥
在向导中或手动编辑.env文件,设置LLM和嵌入模型API密钥。
复制环境变量模板
$ cp .env.example .env编辑.env文件(或使用其他编辑器)
$ nano .env启动DeepTutor
如果使用向导,它会自动启动服务;否则手动启动。
启动后端服务
$ python -m deeptutor启动前端服务(在web目录中运行)
$ npm run dev✅ 验证安装成功
打开浏览器访问DeepTutor界面,确认服务正常运行。
- ✓浏览器打开http://localhost:3782并显示DeepTutor界面
- ✓可以开始聊天或上传文档
⚡ 快速提示
🔍 常见问题排查
❓ 端口冲突导致服务启动失败
→ 修改.env中的BACKENDPORT或FRONTENDPORT,或关闭占用端口的程序
❓ API密钥无效或未设置
→ 检查.env文件中的LLMAPIKEY和EMBEDDINGAPIKEY是否正确填写
❓ Python版本低于3.11
→ 升级Python到3.11或更高版本
🎯 下一步
上传PDF或Markdown文件到知识库
在界面中上传文档,启用RAG功能进行个性化学习
创建TutorBot
设置自主导师代理,用于特定学习场景
探索CLI工具
使用deeptutorcli命令进行高级操作和自动化









