港大开源DeepTutor:你的专属AI导师,让学习真正「活」起来!

DeepTutor · 香港大学数据科学实验室（HKUDS）

DeepTutor 是一个以智能体为核心的个性化辅导系统。它不仅仅是一个聊天机器人，而是一个会持续学习你、记住你、主动陪伴你的AI导师。

上线仅111天，GitHub星标突破 20,000 ——这不仅是数字，更是全球学习者和开发者对这个项目的认可。

“不是问答机器，而是真正懂你的导师。”

一个线程，六个模式。聊天、深度解题、生成测验题、深度研究、数学动画、可视化图表——所有模式共享同一上下文。你可以先随便问个问题，发现有点难就切换到“深度解题”模式让AI分步拆解，然后让它把概念画成图表，再生成几道题考考自己，最后启动“深度研究”深入探索——整个过程一条消息都不会丢失。

这不是一个简单的编辑器，而是一个把AI当作头号合作者的Markdown写作空间。选中一段文字，AI可以帮你重写、扩写、缩写——还能从你的知识库和互联网中提取上下文。每一点创作都可以直接保存到你的学习笔记本中，形成正向循环。

给DeepTutor一个主题，指给它你的知识库，它会自动生成一本结构化的互动书籍——不是静态的PDF，而是包含14种模块的活页书：测验卡片、时间线、概念图谱、互动演示……你可以边读边测、边学边问，书还会随着你的理解不断“生长”。

上传PDF、Markdown、TXT文件，构建可检索的知识库。用彩色笔记本分类整理，在题库中回顾所有生成的测验题，还能创建自定义Skill来塑造DeepTutor的教学风格。文档不再是躺在文件夹里的死文件——它们会活跃地参与每一次对话。

每一次对话，DeepTutor都在构建一个关于你的“活档案”：你学了什么、你是什么水平、你的学习偏好是什么。这个记忆在所有功能和所有导师之间共享——用得越久，它就越懂你。

每个TutorBot都有自己的独立工作空间、独立记忆、独立人格和技能集。你可以同时拥有一个苏格拉底式的数学导师、一个耐心的写作教练、一个严谨的研究顾问——它们各司其职，互不干扰。内置的心跳系统可以让导师定期提醒你复习、发起学习检查。它还可以接入Telegram、Discord、飞书、钉钉等多个平台——你的导师，随时出现在你需要的地方。

DeepTutor 提供了极其友好的入门体验。

前提条件：Python 3.11+、Node.js 18+、npm 9+，以及任意一个LLM提供商的API密钥（OpenAI、DeepSeek、Anthropic等）。

推荐方式——一键安装向导：

git clone https://github.com/HKUDS/DeepTutor.git cd DeepTutor

# 创建虚拟环境（三选一） 

conda create -n deeptutor python=3.11 && conda activate deeptutor   # Anaconda 

python -m venv .venv && source .venv/bin/activate # macOS/Linux   

python -m venv .venv && .venv\Scripts\activate  # Windows  

# 启动向导 

python scripts/start_tour.py

向导会带你完成7个步骤——自动检测、安装、配置，全程无需手动敲pip或编辑.env文件。

完成后运行 python scripts/start_web.py，浏览器会自动打开 http://localhost:3782，你的专属AI导师已经就位。也可以用Docker一键部署，无需本地Python或Node.js环境。

不想打开浏览器？DeepTutor 是完全CLI原生的：

deeptutor chat                                    # 交互式对话 deeptutor run chat "解释傅里叶变换" -t rag --kb 教材   # 单次执行 deeptutor run deep_solve "求解 x^2 = 4"        # 多智能体解题 

deeptutor kb create 我的知识库 --doc 教材.pdf    # 创建知识库 

deeptutor bot create 数学导师 --persona "苏格拉底式数学老师"

人类看富文本格式，AI工具可以取JSON格式——给任何支持工具的智能体看一眼项目根目录的SKILL.md，它就能自主操作DeepTutor。

DeepTutor的迭代速度令人惊叹。仅仅最近一周，就连续发布了v1.3.0到v1.3.3多个版本：

从2025年12月29日正式发布至今，几乎每天都有更新——这种开发活力，背后是一个充满热情的社区。

DeepTutor 给我的感觉，不像是又一个“套壳AI助手”。它真正在思考一个问题：在AI时代，学习应该是什么样的？

答案是：个性化的、持久的、主动的。它不再是“我问你答”的机械对话，而是构建一个围绕你的学习生态系统——知识库、笔记本、记忆、多个导师各司其职——这一切协同工作，陪你走过从入门到精通的完整旅程。

项目采用 Apache-2.0 许可证，完全开源。如果你也觉得这个方向有意思，不妨去GitHub上给个Star，或者亲自体验一下——你的每一次反馈，都在塑造未来教育的模样。