DeepTutor：20K星开源AI学习助手，5种模式+私有TutorBot

你是不是也这样学东西？

报了一堆网课，打开就是犯困；看了几页PDF，转头就忘；遇到难题想问人，深夜找不到老师；笔记记了一堆，从来不翻第二次。更惨的是，大模型聊天窗口开在那，你问一句它答一句，问完就断了——它不记得你上次学了啥，不知道你哪里卡住了，也不会主动提醒你"嘿，该复习了"。

学习这件事，缺的从来不是资料，而是一个真正了解你、持续陪着你的导师。

DeepTutor 是什么？

DeepTutor 是香港大学数据科学实验室（HKUDS）开源的 Agent原生个性化学习助手——不是又一个聊天机器人，而是一个有记忆、有人格、会主动找你的AI导师。39天破10K星，总星超20K，Apache 2.0协议，开源免费。

核心功能一图看懂

安装步骤（手把手）

方式一：Setup Tour（推荐新手）

一条命令启动交互式安装向导，跟着提示走就行：

python scripts/start_tour.py

方式二：手动安装

第一步：克隆项目

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

第二步：安装后端（Python）

Mac / Linux / Windows 通用：

pip install -e .

第三步：安装前端（Next.js）

npm install

第四步：配置环境变量

复制示例文件，填入你的API Key：

cp .env.example .env

编辑 .env，至少填一个LLM的Key。中国用户推荐这几个：

没有Key也不想花钱？用本地的：

第五步：启动服务

# 终端1：启动后端（端口8001）
python -m deeptutor.server

# 终端2：启动前端（端口3782）
npm run dev

打开浏览器访问 http://localhost:3782 即可。

方式三：Docker一键部署

最省心的方式，适合不想折腾环境的用户：

docker compose -f docker-compose.ghcr.yml up -d

启动后后端在 8001 端口，前端在 3782 端口，同上。

方式四：纯CLI（服务器用户最爱）

不需要前端界面，命令行就是一切：

pip install -e ".[cli]"

使用方法：从简单到进阶

基础用法一：交互式聊天

deeptutor chat

进入交互式对话模式，像用微信聊天一样问问题。它会记住你之前聊的内容（持久记忆），不是那种问完就忘的傻聊天。

基础用法二：单次执行

不想进交互模式，一句话搞定：

deeptutor run chat "用大白话解释傅里叶变换"

进阶用法一：多Agent解题（Deep Solve）

遇到复杂题目？Deep Solve会派出多个AI Agent协作解题：

deeptutor run deep_solve "解方程 x^2 = 4"

多Agent会分别负责理解题目、规划解法、验证结果，比单Agent更可靠。

进阶用法二：创建你的专属TutorBot

这是DeepTutor最核心的杀手级功能——创建一个属于你的AI导师：

deeptutor bot create math-tutor --persona "苏格拉底式数学老师，用提问引导我思考而不是直接给答案"

这个TutorBot有自己的工作区、记忆和人格。它记得你上次学到哪了，知道你哪里薄弱，还会通过心跳机制主动提醒你学习。

支持推送到多个通道——你不用打开DeepTutor网页，直接在以下平台收消息：

进阶用法三：知识库管理

把你的学习资料喂给它，之后它会基于这些内容回答问题（RAG检索增强生成）：

deeptutor kb create my-kb --doc textbook.pdf

支持PDF、TXT、Markdown格式上传。

其他实用命令

deeptutor memory show     # 查看AI记住的你的学习者画像
deeptutor session list    # 查看所有会话记录

实际场景举例

跟同类对比

一句话：普通聊天工具是"你问我答"，DeepTutor是"我懂你、我记得你、我主动找你"。

小结

DeepTutor把大模型从"被动问答"变成了"主动教学"——有记忆、有人格、会主动提醒你的AI导师，加上多Agent解题、知识库RAG、数学动画和CLI原生支持，是目前开源学习助手领域完成度最高的项目。无论你是自学考研、公司培训还是论文研究，都值得装一个试试。

项目地址：https://github.com/HKUDS/DeepTutor