GGitHub 趋势观察站
每日 07:00 更新订阅EN
← 今日榜单项目指南 / 学习与研究
HKUDS/DEEPTUTOR

DeepTutor把资料、问题和练习,
放进同一个学习空间。

把知识库、问答、解题和测验连接起来的 AI 学习工作台,支持本地部署,并按任务复用学习上下文。

AI 学习工作台知识库与练习Apache-2.0

本地 Web 应用与 CLI · 模型提供方需自行配置

REPOWATCH 观察

最近记录于 2026-11-01

52,766累计 Star
+1,035该日新增 Star
#1历史最高排名
5 次本站记录上榜
01 / 用途

先围绕自己的资料,
问清一个具体问题。

适合想把课程资料和持续练习放在一起的学习者。它提供学习工作流,回答质量仍取决于模型和资料。

01

带着资料提问

连接知识库、书籍或学习笔记,让支持该上下文的工作流围绕材料展开。

适用于:课程阅读 · 文档问答

02

把理解变成练习

使用解题、测验和掌握路径等模式,围绕一个主题反复学习与检查。

适用于:知识点复习 · 练习生成

03

留下可复用的上下文

把问题、笔记与任务保存在工作空间,并在支持的流程间复用。

适用于:长期学习 · 资料整理

DeepTutor 官方学习对话示例,展示傅里叶变换的解释与公式
在具体流程中理解功能

不是只问一次,
而是保留学习过程。

对话、知识库和笔记由同一个运行系统连接。先把资料与模型配置好,再用一个小主题验证问答和练习是否符合需要。

  • 不同学习模式有各自的任务流程
  • 工作区内容与私有运行配置分开管理
  • 模型与外部连接按需要设置
阅读官方说明 ↗
02 / 使用条件

先选部署方式,
再配置学习模型。

可以使用 Docker 试用,也可以从 Python 包或源码安装;不同方式需要的环境不同。

阅读官方说明 ↗
03 / 开始使用

先用一个知识点走通流程。

阅读官方指南 ↗
  1. 01

    准备运行环境

    按官方说明选择 Docker、包安装或源码方式,确定数据保存位置。

  2. 02

    连接模型和资料

    在设置中配置提供方,添加少量可公开使用的学习材料。

  3. 03

    提问并检查依据

    先问一个明确问题,再尝试解题或测验,并核对回答与原始资料。

官方仍在持续迭代,安装路径和学习模式以当前 README 为准。

安装与配置

DeepTutor
安装与技术说明

优先给出官方发布镜像的本机试用路径。Python 包的模块化安装与当前 dev 源码有版本差异,不与历史安装命令混用。

Docker 路径
安装 Docker 即可试用发布镜像,无需先在宿主机设置 Python/Node.js;浏览器默认访问本机 3782 端口。
本地 Python 包
当前 README 的完整应用路径使用 Python 3.11–3.14、PATH 中的 Node.js 20+,并安装 deeptutor[full];裸 deeptutor 是核心组件。
源码开发
当前 dev 开发路径要求 Python 3.11–3.14 和 Node.js 22 LTS,前后端依赖分别安装。
模型与持久化
先准备所用模型服务的授权;知识库需要相应嵌入配置。保存运行目录或 Docker 数据卷才能保留设置与资料。

按步骤准备与启动

  1. 01

    准备 Docker 并启动本机服务

    使用官方示例将 Web 端口仅绑定本机,并用命名卷保留数据。初次启动需要拉取镜像。

    docker run --rm --name deeptutor -p 127.0.0.1:3782:3782 -v deeptutor-data:/app/data ghcr.io/hkuds/deeptutor:latest
  2. 02

    打开 Web 界面并配置模型

    访问 http://127.0.0.1:3782,在 Settings → Providers 配置提供方,再选择语言模型。确认模型连接成功后再使用聊天或解题。

  3. 03

    配置知识库并验证一份资料

    按所选 RAG 路径设置嵌入服务,添加少量学习材料,确认解析、索引及引用可用后再批量导入。

  4. 04

    需要 Python 安装时使用完整配置

    改走本地包时先建立独立环境和固定运行目录,再安装完整应用配置、运行 deeptutor init,最后运行 deeptutor start。

    pip install -U "deeptutor[full]"
    deeptutor init
    deeptutor start

    这是 Docker 的替代路径,不需要在容器试用成功后再重复安装。1.6.15 及更早 CLI 升级需阅读迁移说明。

技术能力与使用边界

知识上下文

知识库、笔记和会话可以为支持的学习模式提供上下文,解析和嵌入模型需分别配置。

运行数据目录

本地设置位于运行目录或指定 DEEPTUTOR_HOME 的 data/user/settings;Docker 示例保存到 deeptutor-data 卷。

常见安装问题

界面打开但模型没有响应?

界面启动不代表模型配置已完成。核对提供方、接口地址、模型名和账户可用额度,再检查服务日志;云模型仍需要网络。

为什么只装到核心功能?

新模块化包的 bare deeptutor 与 deeptutor[full] 范围不同。核对所用版本和安装配置,旧 CLI 升级前按官方迁移步骤备份原运行目录。

资料核对:2026-10-31 · 根据下列官方文档整理,未进行安装与功能实测。命令中的示例目录、模型与配置需按自己的环境调整。

04 / 常见问题

开始前,
你可能还想知道。

必须把所有资料上传到公共网站吗?

不需要把本地部署理解成公共托管站点。但外部模型、搜索和连接器会各自处理相应数据,具体取决于你的配置。

Docker 试用需要先装 Python 和 Node.js 吗?

官方提供了无需单独设置 Python 和 Node.js 的 Docker 试用路径,仍需安装 Docker 并配置所用模型服务。

知识库能保证答案正确吗?

不能。资料检索只是提供上下文,仍应核对引用、公式、推导和练习结果。

它只有聊天功能吗?

不是。官方还提供解题、测验、研究、可视化、笔记和任务板等功能,具体上下文支持因模式而异。

REPOWATCH / 趋势档案

热度有记录,
选择看用途。

首次记录 2026-10-28 · 主要语言 Python
以下为本站保存的榜单快照,并非实时 GitHub 数据。