零基础实战用本地大模型离线部署 DeepTutor AI学习助手完全指南【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutorDeepTutor 是一款开源离线 AI 学习助手接入 Ollama 等本地大模型后断网也能进行对话学习、知识库检索与协同写作数据始终留在本机。本文带你从零完成部署。能离线部署的私人学习工作台DeepTutor 是一个 Agent 原生的开源项目对话、解题、研究、测验等学习动作都跑在同一个智能体循环上切换任务不需要切换引擎。它适合想在本地跑大模型、重视隐私的学生和自学者。三个特点值得试用知识库内置 LlamaIndex、GraphRAG、LightRAG 等多种检索引擎三层记忆可读取、可编辑任何结论都能追溯到原始记录配置全部是本地 JSON 文件不藏在黑盒里。工作原理从入口到数据的五层架构整套系统分五层。入口层提供 Web、CLI、REST API、Python SDK 四种入口运行时层负责调度对话轮次与统一上下文智能体核心层分两级L2 能力Chat、Deep Solve、Deep Research、Visualize、Mastery Path按需调用 L1 工具RAG、Memory、网页、代码执行、MCP服务层封装 LLM、会话、知识、记忆等能力数据层把设置与学习状态存成本地文件。所有推理与数据流动都发生在你的设备上这是它能完全离线的原因。从零部署三个代码块完成环境要求核对动手前先对照这张清单Python 3.11–3.13必需Node.js 20构建前端内存 8GB 起16GB 更稳磁盘预留 20GB模型加依赖已安装 Ollama 并能启动7B 级模型在 8GB 内存的机器上可以跑只是推理偏慢对速度敏感就选 3B 级。硬件门槛不高瓶颈通常在显存和磁盘。安装与配置先获取代码并安装依赖git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor cd DeepTutor python3 -m venv .venv source .venv/bin/activate python -m pip install -e .进入web目录执行npm ci --legacy-peer-deps构建前端然后下载本地模型ollama serve ollama pull qwen2.5:7b ollama pull nomic-embed-text拉对话模型的同时把嵌入模型也拉下来后面知识库依赖它。接着运行deeptutor init按提示选择端口和 LLM 提供商。启动后在浏览器「设置 → 模型」里完成关键配置LLM 提供商选 OllamaBase URL 填http://localhost:11434/v1模型名填刚才拉取的模型嵌入模型同样选 Ollama填nomic-embed-text。对本地服务实现的细节感兴趣可以看本地 LLM 提供商源码。启动验证deeptutor start终端会打印前端地址默认是http://127.0.0.1:3782在浏览器打开即可。设置页顶部有一条状态栏分别显示 Backend、LLM、Embedding、Search 四项全部转绿说明本地模型已接通。随便发一条测试提问确认回复流式输出正常部署就算完成终端里按CtrlC可同时停掉前后端。核心功能体验对话学习一个循环搞定所有任务场景很直接你在自学微积分卡在一道积分题上。DeepTutor 的对话线程不止于问答——模型按轮次思考、需要时调用工具、观察结果后再作答遇到信息不足还会用ask_user主动停下来向你提问而不是硬猜。同一条线程里可以挂知识库、读附件、生成图片还能从对话直接唤起测验、深度研究、可视化等能力上下文全程跟随你。知识库多引擎 RAG 私有资料库手头的教材、论文和笔记散落在各个 PDF 里在知识中心上传文档建立索引之后 Chat、Co-Writer、Book 等所有功能都能基于这些资料作答。每个知识库绑定一种检索引擎LlamaIndex 是默认选项也可以按需要选 GraphRAG、LightRAG、PageIndex 或链接你的 Obsidian 库。重建索引会写入新版本目录旧索引不会被破坏某份文档解析失败也能单独移除不必整库删掉重来。协同写作对选区做外科手术式修改写实验报告或整理长笔记时打开 Co-Writer 得到一个分屏 Markdown 编辑器左侧写作、右侧实时预览KaTeX 公式直接渲染。它的核心是选区编辑——选中任意一段要求 AI 改写、扩写或精简模型可以引用知识库或网页证据来支撑修改每一次改动都以接受/拒绝的差异视图呈现你点头才生效草稿不会被悄悄改掉。避坑指南问题可能原因解决方法首次启动连不上大模型Ollama 未运行或 Base URL 填错先ollama serveBase URL 设为http://localhost:11434/v1回复很慢、输出卡顿模型超出本机推理能力换 3B/7B 级更小模型关闭占用内存的程序知识库检索没有结果未配置嵌入模型设置里给 Embedding 选 Ollama拉取nomic-embed-textDocker 里连不到宿主机模型容器内 localhost 指向容器本身加--add-hosthost.docker.internal:host-gateway地址改用host.docker.internal浏览器打不开前端端口被占用或前端仍在构建deeptutor init时换端口或等构建完成看终端打印的地址Docker 部署的更多细节rootless、端口映射可以查仓库里的容器化指南。写在最后本地大模型还在快速进化离线学习助手正变得人人可跑。现在就 clone DeepTutor、接上 Ollama向你的私人导师问出第一个问题吧。延伸阅读简体中文 README【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
