DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.
💡 Use Cases
DeepTutor最适合需要个性化、多模式、可扩展的AI学习助手场景,尤其适用于自主学习、企业培训和研究辅助,兼顾终端用户和开发者需求。
个性化学习辅导
Problem: 传统AI助教只能回答固定问题,无法根据学生进度动态调整教学内容和方式。
Solution: DeepTutor利用多智能体系统和会话记忆,能跟踪学习进度,自动切换深度解答、测验生成、深度研究等模式,提供持续适应的学习路径。
Example: 学生先提问一个数学题,DeepTutor给出详细解答后,自动生成相关测验,再深入推荐扩展资料,全程保持上下文连贯。
文档驱动的知识问答
Problem: 需要从大量文档(如PDF、Markdown)中快速提取信息并回答专业问题,但手动检索效率低。
Solution: 通过RAG知识库系统上传文档,DeepTutor自动索引并支持基于文档的问答,结合多轮对话精准定位答案。
Example: 上传公司内部技术手册后,开发者直接问“如何配置数据库连接池”,DeepTutor从手册中提取相关章节并给出步骤。
命令行智能助手
Problem: 开发者在终端中需要快速获取代码建议、调试帮助或执行复杂任务,但缺乏上下文感知的交互工具。
Solution: DeepTutor提供CLI工具,可在终端中直接启动智能对话,支持代码补全、错误排查和任务自动化,无需切换界面。
Example: 在终端输入`tutor debug`并粘贴报错日志,DeepTutor自动分析错误原因并给出修复建议。
多通道机器人教学
Problem: 需要在不同平台(如Discord、Web)上提供统一的教学服务,但各平台独立开发成本高。
Solution: TutorBot支持多通道部署,每个机器人拥有独立记忆和技能集,可在不同平台间同步学习进度和个性化设置。
Example: 学生在Discord上提问,TutorBot记录学习状态;之后在Web端继续学习时,系统自动恢复上次对话和测验结果。
📊 Project Info
- Language
- Python
- Stars
- ⭐ 26,237
- Forks
- 3,561
- Today
- +172
- Ranking
- #8
- Collection
- Overall
- Trending Date
- July 15, 2026
- Last Push
- 7/9/2026
🏷️ Topics
5分钟快速开始DeepTutor
DeepTutor是一个原生智能体驱动的个性化学习助手,通过AI代理提供交互式学习体验。
🖥️ OS
⚙️ Runtime
🔧 Tools
📝 Steps
克隆项目并进入目录
从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界面
- ✓可以开始聊天或上传文档
⚡ Quick Tips
🔍 Troubleshooting
❓ 端口冲突导致服务启动失败
→ 修改.env中的BACKENDPORT或FRONTENDPORT,或关闭占用端口的程序
❓ API密钥无效或未设置
→ 检查.env文件中的LLMAPIKEY和EMBEDDINGAPIKEY是否正确填写
❓ Python版本低于3.11
→ 升级Python到3.11或更高版本
🎯 Next Steps
上传PDF或Markdown文件到知识库
在界面中上传文档,启用RAG功能进行个性化学习
创建TutorBot
设置自主导师代理,用于特定学习场景
探索CLI工具
使用deeptutorcli命令进行高级操作和自动化









