DeepTutor 家教

香港大学团队开源的个人 AI 家教,能记住你的学习进度、按你的水平出题讲解,装在自己电脑上,数据不上传,免费。

一般 AI 家教 学习 开源 本地部署 智能体 出题 最近更新:2026-10
去 DeepTutor 家教 官网注册 / 打开 ➜

怎么用

DeepTutor 是香港大学数据科学实验室(HKUDS)开源的一个「私人 AI 家教」,目前有近 5 万人在 GitHub 上收藏,用 Apache 2.0 协议免费开源。它跟普通聊天机器人的区别是:它会记住你学到哪儿、哪儿薄弱,然后针对性地讲解、出题、画图、甚至给你生成一节带旁白的视频课。所有资料和进度都存在你自己的电脑上。

一、它能帮你做什么

  • 对话辅导:像老师一样一问一答,可以上传教材、讲义当依据,答案会引用你的资料
  • 自动出题 + 批改:按你上传的内容生成练习题,错的题会反复出现,帮你查漏
  • 精熟路径:把一门课拆成阶段,只有掌握上一段才解锁下一段,防止「假装学会了」
  • 解题讲过程:不只是给答案,会把推导步骤写出来
  • 可视化:把抽象概念画成图表、可交互页面甚至动画
  • 活书(把资料编成电子书):把你的笔记、题库、聊天记录整理成一本可点、可测、可聊的电子书
  • 视频课:自动生成带旁白的讲解视频
  • 知识库:上传 PDF、课件、网页,建自己的资料库,之后所有回答都基于它
  • 数据全在本地:学习记录、上传的资料都存在你自己电脑的文件夹里,不上传第三方

二、怎么打开 / 安装

它是开源软件,要装在自己电脑上。最省事的是 Docker 一条命令,不用配环境:

  1. 先装好 Docker Desktop(Windows / Mac 都有官网安装包,装完启动它) 👉 点此直达 DeepTutor 家教 官网 / 应用商店打开 →
  2. 打开终端(Windows 用 PowerShell,Mac 用「终端」),粘贴这一行回车:

`` docker run --rm --name deeptutor -p 127.0.0.1:3782:3782 -v deeptutor-data:/app/data ghcr.io/hkuds/deeptutor:latest ``

  1. 等它下载完(第一次要几分钟),浏览器打开 http://127.0.0.1:3782
  2. 进 Settings → Providers,填一个大模型的接口(OpenAI 兼容接口、通义、DeepSeek、Kimi 都行;也可以接本地跑的 Ollama)
  3. 保持那个终端窗口别关,关了服务就停了
不想用 Docker 的话,也可以用 Python 装:pip install -U "deeptutor[full]",然后 deeptutor init 跟着提示走、deeptutor start 启动。需要 Python 3.11 以上。

三、第一次怎么用(照着做就行)

  1. 打开 http://127.0.0.1:3782,界面右上角把语言切成「简体中文」。
  2. 先去 Settings → Providers 填模型:把你已有的接口地址和密钥粘进去,点测试,通了再往下。
  3. 进 知识中心,上传一份你想学的资料(孩子的课本某一章、你的培训讲义、一份 PDF 都行)。
  4. 回到 对话,选中刚才那个知识库,问一句:「用初中生能听懂的话讲讲这一章的重点」。
  5. 再进 出题,让它在同一份资料上出 5 道题,做完看它怎么讲错题。
  6. 用顺手了再试 精熟路径,让它给你排一条两周的学习路线。

四、可以直接复制的提示词

  • 我是零基础,请用生活里的例子解释这一章的核心概念,每讲一个概念给我出一道小题。
  • 根据我上传的资料出 10 道选择题,难度从易到难,做完帮我分析错在哪一类知识点。
  • 把这份资料整理成一页复习提纲:3 个核心概念 + 2 个易错点 + 1 个记忆口诀。
  • 我这次错了 3 道题,都是关于同一个知识点,请换个角度再讲一遍,然后出 3 道同类题。
  • 帮我规划两周学完这份材料的学习计划,每天 40 分钟,标出哪天该复习。

五、好用的小技巧

  • 先喂资料再提问:不建知识库直接问,它就退化成普通聊天机器人,记住的东西也少。
  • 让孩子自己操作:出题、看讲解、点「没听懂」重讲,比家长在旁边念有效。
  • 一个科目一个知识库:数学、英语分开建,回答不会串。
  • 善用「活书」:把一学期的资料编成一本,期末复习时按章节过一遍特别省事。
  • 本地模型也能跑:电脑性能够的话接 Ollama,连模型调用费都省了。

六、注意事项

  • 它不是玩具,装起来有点门槛:要装 Docker、要自己填模型接口,第一次大概要折腾半小时。搞不定就先别硬上,用现成的 AI 聊天工具也能学。
  • 模型调用要花钱:软件本身免费,但背后的大模型按用量计费(接本地模型除外),长对话、长视频课消耗得快。
  • 别在上面存敏感信息:身份证、病历、公司内部资料不要上传,哪怕它存在本地——你接的模型接口仍然会看到内容。
  • AI 讲课会讲错:数学推导、历史年份、公式,务必对照教材核一遍。
  • 只从官方渠道下载:认准 github.com/HKUDS/DeepTutor,别下所谓「汉化破解版」「一键安装包」,那是木马重灾区。
✅ 教程看完了?照着练一遍(就这个工具干的那件事)