DeepTutor 完整教程:5 分钟跑起你的 AI 学习智能体【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor上周我让 AI讲讲 B 树是怎么工作的,答案一半对一半错。换成 DeepTutor,先把攒了一学期的数据库课件传上去,再问同一个问题——这次回答引用了课件里的章节,结尾还附了道自测题。差别不在模型,在 DeepTutor 把回答锚定在你的资料上,还记得你学到哪了。DeepTutor 是一个开源的 AI 学习智能体平台:聊天、解题、出题、深度研究、可视化、知识管理,全部跑在同一个 agent 循环里。下面从零开始,带你走到第一次真正知道你的学习上下文的那次对话。核心能力速览:它能替你解决什么你遇到的问题DeepTutor 的对应解法通用回答答不到你的教材上多引擎 RAG 知识库(LlamaIndex / GraphRAG / LightRAG / 关联 Obsidian 库)想系统吃透一本书Book活教材:把资料编译成带章节大纲、测验、闪卡的交互书题目不会做、想验证学习过程Deep Solve 分步求解、Mastery Path 掌握度路径想有个常驻手机端的学伴Partners:接飞书、Telegram、Slack 等 IM,同一个大脑你住在终端里一个 CLI 全搞定:deeptutor chat / run / kb / skill一句话:同一个智能体引擎切换不同任务,知识库、笔记本、三层记忆这些上下文跨功能共享。 不必一次全用,跑通Chat 知识库这两样,就能感受到差别。5 分钟跑通第一次对话前置要求:Python 3.11–3.13、Node.js 20。推荐流程是定一个工作目录 → 安装 → init → start,配置和数据都落在这个目录的data/user/settings/下。# 建一个工作目录,它就是数据根 mkdir my-deeptutor cd my-deeptutor # 装完整版(本地 Web 应用 CLI) pip install -U deeptutor # 交互式设置端口、LLM 供应商、API key、可选 embedding 模型 deeptutor init # 同时启动前后端,保持终端不关 deeptutor startdeeptutor init会依次问你后端端口(默认 8001)、前端端口(默认 3782)、模型供应商、Base URL、API key 和模型名。跳过 init 也能启动,只是模型配置为空,之后在 Settings → Models 里补。浏览器打开http://127.0.0.1:3782,你会看到主界面,Chat 是默认入口:AI 学习助手 DeepTutor 的主界面,侧边栏汇集 Chat、Partners、Knowledge、Book、Memory 等日常入口在底部输入框发一个问题,就能拿到第一条回答。如果你要基于源码跑(或开发模式),安装段换成:git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor cd DeepTutor python3 -m venv .venv source .venv/bin/activate pip install -e . (cd web npm ci --legacy-peer-deps) deeptutor init deeptutor start --dev # --dev 开启前端热更新深入一个场景:把自己的资料变成私教DeepTutor 最有价值的地方,是每项能力都能锚定你自己的资料。知识库这条路径最短:侧边栏进入Knowledge Center,点Create New,上传文档(PDF、Markdown 等);选检索引擎,等索引完成。默认 LlamaIndex 是本地向量 BM25,最省心;回 Chat,在输入框工具条的KB chip上勾选刚建的知识库;提问。回答会给出引用来源,rag工具调用过程可以在 Activity 面板逐条查看。知识库界面支持多文档管理与索引版本化,是 DeepTutor AI 学习助手的资料底座背后机制值得一看:Chat 是一个 agent 循环——模型按轮次思考,需要时调工具(web_search、rag、reason…),观察结果,再给出无工具调用的收尾回答。循环实现在 agents 模块,想读源码从这里入手。思考—行动—工具调用—观察—响应的循环,是 DeepTutor AI 智能体的核心机制顺手再试一下Book:从知识库生成一本活教材。创建流程会先给出章节大纲让你确认,再逐章编译成正文、测验题、闪卡等块,每页还有独立的 Page Chat。它不是把 PDF 换个皮肤。DeepTutor 把上传资料编译成结构化教材的 Book 库界面容易踩的坑:三种现象对照排查现象:打开页面空白,或提示连不上。原因:端口不对,或deeptutor start的终端已经退出。默认前端端口是 3782,不是网上旧教程里的 3784。 解法:以终端启动后打印的 URL 为准;改过端口的话,按新值访问。现象:知识库建好了,回答却从不引用资料。原因:没配 embedding 模型。init 时如果跳过了 embedding 提示,KB 能建但 RAG 不工作。 解法:在 Settings → Models 里补一个 Embedding profile,回知识库页重新索引。现象:Docker 里连本机 Ollama 超时。原因:容器内的localhost是容器自己,不是你的机器。 解法:启动时加--add-hosthost.docker.internal:host-gateway,Base URL 指向http://host.docker.internal:11434/v1。更多部署形态见 CONTAINERIZATION.md。⚠️ 另注:deeptutor start --dev若提示前端卡住,多是残留锁文件,删掉web/.next/dev/lock和web/.next/lock再启动即可。延伸:接着玩的三条路换本地模型:在 Settings → Models 加一个 Ollama 或 LM Studio profile(Base URL 如http://localhost:11434/v1),整套学习流程就能全本地、零费用跑。让智能体驱动它:deeptutor run deep_solve Solve x^24 --tool rag --kb my-kb --format json会逐行输出 NDJSON,方便把你自己的自动化管线接进来;仓库根目录的 SKILL.md 是给其他 agent 的交接文档,让它一次读会全部用法。装社区技能:deeptutor skill install socratic-tutor从 EduHub 拉一个苏格拉底式提问技能,聊天里的互动风格立刻不同。如果完全不想装 Python,Docker 单容器也能跑完整 Web 应用:docker run --rm --name deeptutor \ -p 127.0.0.1:3782:3782 -v deeptutor-data:/app/data \ ghcr.io/hkuds/deeptutor:latest下一步:建你的第一个知识库现在挑一份你一直吃灰的资料,按前面四步建个知识库,然后对 DeepTutor 说考考我。一轮下来,你就知道这个 AI 学习智能体适不适合你的学法。更多细节回仓库的 README 查完整功能导览和版本发布记录。【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考