3步搞定离线AI学习助手：DeepTutor本地部署完整指南

3步搞定离线AI学习助手DeepTutor本地部署完整指南【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor出差没网、机房电脑连不了外网你还想让 AI 帮你答疑吗DeepTutor 是一款离线AI学习助手搭配 Ollama本地大模型推理工具把大模型跑在自己电脑上装好之后不联网也能用所有数据都留在本机。它解决了什么问题想两个场景。一个是你在飞机或者高铁商务座上完全没信号想让 AI 陪你把昨晚没读完的论文过一遍。另一个是机房、实验室的电脑禁止联网教材资料不能传上云但你希望 AI 看懂你的材料再基于材料答题。DeepTutor 就是按这种需求来的模型跑在本地资料、对话记录、记忆都存在本地目录里。联网只发生一次——下载模型。 原理速览它是怎么做到的需要理解三件事。模型跑在你自己机器上。Ollama 是一个本地大模型运行器模型权重放在硬盘里推理全部由你的 CPU/GPU 完成。打个比方这相当于家里装了个私人图书馆查书不用出门。接口是标准插座。DeepTutor 的模型提供商注册表把 Ollama 作为本地提供商内置走的是 OpenAI 兼容接口一种大多数大模型服务通用的 API 格式。所以从云端 API 换成本地 Ollama只是改一个地址用法不变。数据不出机器。知识库、对话记忆、学习笔记都在本地数据目录里。提问走 RAG检索增强生成即先检索你的资料、再让模型作答时整条链路也在本地完成。 搭建全流程3步完成DeepTutor本地部署第一步获取代码并安装依赖git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor cd DeepTutor python3 -m venv .venv source .venv/bin/activate pip install -e .venv 是虚拟环境给项目单独隔一片 Python 环境避免和其他项目打架pip install -e .会一并装好后端和命令行。环境要求 Python 3.11 和 Node.js 20前端基于 Next.js需要 Node 环境。第二步安装Ollama并拉取本地模型curl -fsSL https://ollama.ai/install.sh | sh ollama pull llama3.2这是全流程唯一必须联网的一步模型权重落到硬盘后就可以拔网线继续用。用ollama list能查本地已有哪些模型8GB 内存选 3B 级别的更稳16GB 以上可以上 7B。第三步初始化并启动DeepTutordeeptutor init deeptutor startdeeptutor init会让你选择 LLM 提供商选 Ollama地址默认http://localhost:11434/v1模型从你本地列表里挑。想用知识库的话再加一个本地 embedding 模型embedding 模型是把文字变成向量的小模型用来检索相似段落Ollama 同样能提供。启动后浏览器打开http://127.0.0.1:3782就能用了。懒得配环境也可以直接用官方 Docker 镜像细节看 CONTAINERIZATION.md。 实际用起来什么样卡题时直接问。场景复习时一道讲义题目完全看不懂。操作打开对话把题目发过去。效果AI 分步讲解还记得你前面问过的上下文记录存本地。基于你自己的资料答题。场景一文件夹的课件和 PDF想让 AI 只按你的材料回答。操作传到知识库系统自动切块建索引。效果提问时 AI 会引用资料里的具体段落作答而不是泛泛而谈。整理笔记和论文。场景答辩前想把实验部分润色一遍。操作打开 Co-Writer把草稿贴进去让 AI 逐段改。效果LaTeX 公式、代码块都能原样渲染边写边改。 遇到报错怎么办连不上 Ollama。现象聊天时提示模型服务不可用。排查终端执行curl http://localhost:11434/api/tags看 Ollama 服务是否活着再检查初始化时填的地址是否带/v1后缀。解决把 Ollama 服务起起来Base URL 写成http://localhost:11434/v1如果 DeepTutor 跑在 Docker 里主机名要改成host.docker.internal。响应特别慢。现象一个字要等半分钟机器发烫。排查看任务管理器里的内存占用用ollama list核对模型大小和你的硬件是否匹配。解决换更小的模型比如ollama pull qwen2.5:3b顺手关掉后台大程序。网页打不开。现象访问127.0.0.1:3782提示连接被拒绝。排查确认跑deeptutor start的终端还活着再查 3782 端口是不是被别的程序占了。解决停掉占用端口的程序或者在初始化时换个端口。一句话总结DeepTutor 把大模型从云端搬进你自己的机器你问过的、你上传的、你写的都留在本地。现在打开终端clone 下来3 步跑起来试试。【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考