DeepTutor 从 0 到 1：3 条命令拉起一个真正陪学的本地 AI 导师-平芜编程栈

DeepTutor 从 0 到 1：3 条命令拉起一个真正陪学的本地 AI 导师

【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor

DeepTutor 是一个开源的“智能体原生”个人学习工作台，一条命令启动本地 AI 导师，能聊天、出考题、做深度研究、管知识库，数据全部留在你自己的机器上。

凌晨赶论文，参考文献散在三个文件夹，你只想问一句“帮我理一下思路”。或者孩子问“为什么天空是蓝色的”，你想给的答案比一句百度百科更靠谱。普通问答模型要么答得太浅，要么泛泛而谈——你缺的是一个记得住上下文、知道你学到哪、还知道你上次卡在哪的导师。

DeepTutor：不只是聊天框的 AI 导师

它不是聊天框，而是一套“智能体原生”的个人学习系统：聊天、测验、深度研究、解题、可视化、掌握度练习，全部跑在同一套 agent loop 上，换个模式只是换了目标，上下文跟着学习者走。知识库、书籍、笔记、学习记忆也全部互通，你的学习资料不会散落在一堆各不相通的工具里。

三个值得先看的能力

同一台引擎，任务随便切

聊天、出题、研究、解题共用同一个循环，思考、行动、工具调用、观察、响应五步全程可见。你不用猜它为什么这么答，每一步都能点开看。

智能体五步循环，每步可见

你的资料就是它的教材

把教材、讲义、论文 PDF 传进知识库，它基于你的材料作答。索引引擎可以在 LlamaIndex、GraphRAG、LightRAG、PageIndex 之间切换，甚至能直接挂载一个 Obsidian 库，引用没有出处时它会承认，而不是编。

知识库界面：上传、索引、检索一处搞定

学习轨迹变成看得见的知识图谱

记忆分三层：会话细节、表层摘要、综合理解，你可以随时查看、编辑、删除。图谱里每一条结论都能回溯到原始证据，它教过你什么、你哪里没听懂，写得清清楚楚，而不是“阅后即焚”。

记忆图谱：学习轨迹与知识关联一目了然

能力看完了，试试把它跑起来。

5 分钟跑起来

最短路径是从 PyPI 装（需要 Python 3.11+ 和 Node.js 20+）：

mkdir my-deeptutor && cd my-deeptutor pip install -U deeptutor deeptutor init deeptutor start

deeptutor init会交互式地问你端口、模型提供商和 API Key；启动后在浏览器打开http://127.0.0.1:3782就到了。想用 Docker 的话，官方镜像单容器运行，只需对外发布 3782 这一个端口，配置和知识库都持久化在数据卷里。想改代码的话，先 clone 仓库走源码安装：

git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor

主界面：聊天、书籍、知识库、记忆一屏全见

跑起来之后，它更像同事而不是工具。

三种真实用法

给读文献的研究生：把 30 篇论文丢进知识库，直接问“这几篇的观点分歧在哪”。它会给出对比加出处引用；接着把结论存进书籍，按章节组织，下次问同类问题它接着章节聊，而不是从头科普。

给自学编程的人：在聊天里切到解题模式，让它陪你一步步推题。推完自动生成一组小测验检验你是否真会，答错的题会进题库，隔几天再考你一次。

给团队沉淀知识：用 Partners 把它接进飞书或 Telegram，群里遇到问题直接 @它，它基于团队共享的知识库回答。慢慢就攒下一份全员可查的问答语料，新人入职少问一半问题。

Partners 界面：多用户、多通道协作

配置上总有几个第一次必踩的坑。

避坑与进阶

先配模型，再谈学习：init之后去 Settings → Models 配一个能调通的服务（OpenAI 兼容接口或本地 Ollama 都行）。不配也能启动，但导师只会干瞪眼。
Docker 连本地模型别用 localhost：容器里的 localhost 指向容器自己；模型服务跑在宿主机上时，base URL 要写host.docker.internal，否则连不通。
想改行为先看提示词：agent 逻辑在 deeptutor/agents/，检索流水线在 deeptutor/knowledge/，记忆与伙伴通道分别在 deeptutor/services/memory/ 和 deeptutor/partners/。改 prompt 比改代码的性价比通常更高。

到这里，够你把第一台导师上线了。