DeepTutor 离线部署指南Ollama 本地模型四步跑通【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutorDeepTutor 是一个开源的 AI 学习助手主打终身个性化辅导。它的痛点解决得很具体普通聊天机器人不了解你在学什么、建不起自己的知识库、也没有持续记忆。这篇文章带你把 Ollama 本地模型装好、把 DeepTutor 指过去得到一个完全离线可用的学习助手全程不需要任何云端 API key。DeepTutor 本地能干什么部署完成后的日常用法主要是三件事在 Chat 工作区里就某个知识点和它辅导式对话模型会自己调用 RAG、代码执行等工具把课件文档上传到 Knowledge Center 建成知识库让回答有据可查用 Co-Writer、Book、Learning Space 处理写作、结构化笔记和掌握度练习。底层的聊天、出题、解题、调研跑在同一个 Agent 循环里上下文跨模式共享换模式不用换引擎。动手前先看这份清单项目要求系统Linux / macOS / WindowsPython3.11–3.13Node.js20 及以上构建前端需要内存至少 8GB推荐 16GB7B 模型吃内存磁盘20GB 以上空闲模型 依赖 运行数据必备工具就 Git、pip 和 Ollama 三样前两个大多已装。Ollama 在 Linux 上一条命令装好curl https://ollama.ai/install.sh | sh从零到第一次启动把项目拉到本地源码部署需要仓库在工作目录里clone 下来即可git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor cd DeepTutor如果不想碰源码也可以用pip install -U deeptutor从 PyPI 直接装完整应用跳过 clone 这一步。装好 Ollama 并拉取模型Ollama 是本地模型引擎推理全靠它。启动服务后拉两个模型一个 7B 对话模型负责回答qwen2.5 中文表现好一个嵌入模型负责知识库向量化。模型下载是全程唯一需要联网的环节拉完即可断网使用。ollama serve # 服务常驻建议放 tmux 或后台 # 新终端执行 ollama pull qwen2.5:7b ollama pull nomic-embed-text让 init 指向本地模型deeptutor init是引导式配置跟着提示走后端端口默认 8001、前端 3782LLM 提供商选 OllamaBase URL 填http://localhost:11434/v1模型名填qwen2.5:7b嵌入选nomic-embed-text。配置最终写在data/user/settings/主要是model_catalog.json之后随时可以在网页 Settings → Models 页微调不必重复 init。装依赖并起服务创建虚拟环境装后端与前端依赖然后启动python3 -m venv .venv source .venv/bin/activate python -m pip install --upgrade pip python -m pip install -e . ( cd web npm ci --legacy-peer-deps ) deeptutor start首次启动会构建一次web/前端多花几分钟属正常之后启动就快了。端口被占用时重新跑deeptutor init改端口即可终端里CtrlC同时停掉前后端。首次访问后做什么启动后浏览器打开http://127.0.0.1:3782第一屏就是聊天工作区左侧栏挂着 Memory、Knowledge Center、Settings 等入口。先随便问一句确认本地模型响应正常再上传一份 PDF 到 Knowledge Center 建库在输入栏选中它提问就能看到读过你的材料和没读过的区别。不满意一个答案时切换到 Quiz 或 Research 能力本地模型也能出题和带引用地调研。大概率会踩的坑找不到模型或连接失败多半是 Ollama 服务没起或 Base URL 漏了/v1后缀。确认ollama serve在跑把地址改成http://localhost:11434/v1。回答慢、机器卡7B 模型要吃约 8GB 内存内存紧张就换成qwen2.5:3b重跑 init。前端端口被占用deeptutor init里改前端端口启动日志会打印新地址。Docker 里连不上本机 Ollama容器内的 localhost 指向容器自己。Base URL 改为http://host.docker.internal:11434/v1Linux 下启动时加--add-hosthost.docker.internal:host-gateway。更多容器化场景的排障见 CONTAINERIZATION.md。现在你手里有什么一台带本地模型的机器一个网页版学习工作区数据全部落在本地data/目录。上手之后可以继续探索 Partners把学习助手接到 IM 平台和 Co-Writer选中一段文字做外科式改写都是离线可用。【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考