
DeepTutor 上手指南免费部署你自己的 AI 智能导师【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutorDeepTutor 是一款免费开源的 AI 智能导师系统集聊天答疑、知识库检索、协同写作和三层学习记忆于一体。这篇指南带你用几条命令把它在本地跑起来并按真实使用场景讲清楚每个功能怎么用。DeepTutor 是干什么的谁会用到它DeepTutor 可以理解为一个住在你自己服务器上的 AI 导师它不只回文字还能检索你上传的资料作答、把公式画成动画、陪你改稿并且会把你的学习习惯记下来。项目采用 Apache 2.0 许可代码完全开放。以下几类人用得上它学生上传课件和教材建知识库聊天时直接基于自己的资料提问、生成测验题写论文或技术文档的人用 Co-Writer 分栏写作选中一段让它改写、扩写改动逐条确认教师或培训负责人把讲义变成带测验卡、动画、交互组件的互动教材Book 功能多用户模式下还能给每个学生隔离的工作区想 100% 本地跑模型的人可以接 Ollama、LM Studio、llama.cpp 等本地服务资料不出内网把 AI 接入 IM 的极客把它接到飞书、Telegram、Slack、钉钉、QQ、企业微信等聊天平台导师 7×24 在线5 分钟把 DeepTutor 跑起来 最短路径是从 PyPI 直接安装不需要克隆代码、不需要改配置。先确认环境Python 3.11–3.13和Node.js 20都在 PATH 中然后pip install -U deeptutor deeptutor init deeptutor startdeeptutor init会依次问你后端端口默认8001、前端端口默认3782、LLM 提供商 / Base URL / API key / 模型名以及可选的 embedding 服务只有要用知识库 RAG 才需要。deeptutor start会同时拉起后端和前端在终端打印出访问地址浏览器打开http://127.0.0.1:3782就进去了。在同一个终端按CtrlC可以停掉整个服务。两个小提醒不想在命令行里配模型直接跳过也可以启动后到网页的Settings → Models里填没有 Python 环境用 Docker 一条命令起单容器镜像ghcr.io/hkuds/deeptutor:latest只需要发布3782一个端口设置和数据存在deeptutor-data卷里重启不丢按你的真实用法走一遍下面不按模块名介绍而是按你想让它帮你做什么来。先建一个知识库让它基于你的资料回答想让 AI 回答有据可依第一步是给它喂资料。进入Knowledge Center新建知识库、上传 PDF、Word、Markdown 等文件系统会自动分块、向量化并建立索引。之后在 Chat 里选中这个知识库问题就会基于你的文档作答而不是凭模型记忆瞎编。检索引擎可以每个库单独选默认的LlamaIndex本地向量 BM25适合大多数场景另有 PageIndex、GraphRAG、LightRAG 等可选解析引擎MinerU、Docling、PyMuPDF4LLM 等在Settings → Knowledge Base里切换。具体实现可以看 deeptutor/services/rag/。聊天时顺手让它查资料、算题、画图Chat 是主战场。它的工作方式是想一轮、调一次工具、看结果、再想一轮直到给出最终回答——所以同一个对话里你可以先让它读附件、再让它联网搜索、最后让它把结论写进笔记本上下文都接得上。几个高频动作问不确定的事时它会调用web_search、reason等工具而不是硬答选中某个知识库后rag工具自动挂载回答会引用库内内容要图表用Visualize生成 Chart.js 图表、Mermaid 流程图要数学推导的动画用Math Animator生成 Manim 视频要一份带引用的调研报告在 Chat 里发起Research它拿不准时会暂停提问ask_user机制你答完它再继续不会猜着往下走和 AI 一起写报告、写笔记Co-Writer 是一个分栏的 Markdown 工作区左边写右边实时预览LaTeX 公式、图表都能渲染文档自动保存。它的核心玩法是外科手术式编辑选中一段文字要求它改写、扩写或压缩AI 会带着工具调用轨迹给出修改所有改动以 diff 形式展示你逐条接受或拒绝不满意的修改不会落进文档。成稿之后还能存回笔记本变成以后可复用的上下文。把一堆资料做成一本能互动的教材如果你有一批文档想系统讲给别人听Book 功能可以把知识库、笔记或题库编译成一本活页教材先生成章节大纲给你审再生成内容每章由文字、提示框、测验卡、闪卡、时间线、代码、图表、交互动画等可编辑的块组成每页还带独立的页内对话。块可以插入、移动、换类型不用重写整章。把它接进 IM手机上也能找它Partners让你给导师配一个人设 号码每个 Partner 有独立的灵魂设定SOUL.md、模型策略、记忆和工具权限消息从飞书、Telegram、Slack、Discord、钉钉、QQ、WhatsApp、Mattermost、Matrix 等渠道进来都会走和网页 Chat 完全相同的一条 Agent 链路。想试试的话在网页的 Partners 页面建一个配上对应平台的凭据即可。进阶速览看懂它的架构和关键配置所有功能跑在同一个 Agent 引擎上Chat、Quiz、Research、Visualize、Solve、Mastery Path 只是换了目标不是换了一套程序上下文随学习者走。相关代码集中在 deeptutor/agents/。几条值得知道的配置事实所有配置都是纯 JSON/YAML 文件放在工作区目录下的data/user/settings/网页 Settings 页就是它们的可视化编辑器记忆分三层且全部可见可编辑L1是各场景的原始事件流水L2是按场景整理的事实L3是跨场景合成的知识L2 引 L1、L3 引 L2每条它认为我懂什么都能追溯到出处多用户认证默认关闭单用户模式开启后第一个注册的用户成为管理员其余用户各自拥有隔离的工作区DeepTutor 三层记忆图谱L1 事件流水、L2 场景事实、L3 跨场景知识常见问题从第一次启动到多人共用第一次启动模型在哪配两条路安装时deeptutor init交互式填写或跳过它启动后打开Settings → Models添加一个 LLM 档案Base URL、API key、模型名保存即可。只有要建知识库才需要再填一个 embedding 档案。设置页顶部的状态条会实时显示 Backend、LLM、Embedding、Search 四路连接是否健康。想完全不联网、用本地模型可以DeepTutor 对本地推理服务支持得比较全装好对应服务后把 Base URL 指过去ollama pull llama3.2 ollama pull nomic-embed-text本地服务默认 Base URL在 Settings → Models 填写说明Ollamahttp://127.0.0.1:11434/v1最省事LLM embedding 都支持LM Studiohttp://127.0.0.1:1234/v1图形界面适合选模型llama.cpphttp://127.0.0.1:8080/v1轻量 C/C 推理一个常见坑如果用 Docker 部署 DeepTutor、模型跑在宿主机上容器里的localhost指的是容器自己要把地址换成http://host.docker.internal:11434/v1这类宿主机网关地址。另外注意DeepTutor 本身只是个 Web 应用不吃多少配置真正吃硬件的是你接的本地模型模型能不能流畅跑取决于它自己的体积和你的显卡/内存。知识库某个文档解析失败索引卡住先确认Settings → Knowledge Base里的解析引擎适合你的文件类型纯文本、MinerU、Docling、markitdown、PyMuPDF4LLM 各有擅长。如果单个文档解析报错不用删库重建现在的版本支持单独移除那一个失败文档即使是 error 状态的修好再传。重新建索引时会写新的version-N目录、保留旧索引工作中的索引不会被中途毁掉。多人共用一台数据会串吗默认不会开启多人。要共享部署时打开data/user/settings/auth.json里的认证开关重启后到/register注册第一个管理员再从/admin/users添加用户并分配模型、知识库和技能权限。每个用户的聊天历史、记忆、笔记、知识库都隔离在data/users/uid/下普通用户看到的设置页是脱敏的只能看到管理员分配给他的选项看不到 API key。相关实现见 deeptutor/multi_user/。资源入口项目仓库git clone 使用https://gitcode.com/GitHub_Trending/dee/DeepTutor官方文档deeptutor.info指南、参考、功能导览社区Discord 频道、GitHub Discussions 和仓库 Issues功能投票在 Roadmap issue 里仓库内快速入口CONTRIBUTING.md 贡献指南、SKILL.md 教其他 Agent 怎么调用 DeepTutor 的完整交接文档、CONTAINERIZATION.md 容器化部署细节【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考