DeepTutor 学习工作区

核心信息

以下信息由程序从官方接口读取，不经模型改写。

仓库地址: https://github.com/HKUDS/DeepTutor
许可证: Apache-2.0
语言: Python
维护方: HKUDS
主页: http://arxiv.org/abs/2604.26962
核验日期: 2026-10-31

它是什么

DeepTutor 是一个智能体原生的学习工作区，在一个可扩展的系统中连接辅导、解题、测验生成、研究、可视化和掌握练习。Chat、Ask Questions、Quiz、Research、Visualize、Solve、Mastery Path、Immersive Reading 和 Audio Overview 共享一个能力运行时和会话上下文，同时保留各自专用的循环和流水线。项目采用 Apache License 2.0 许可。

主要能力

任务看板可以在待办、进行中和已完成中跟踪学习任务，带有笔记、可拖放或可用键盘操作的移动按钮，以及可恢复的归档。
在 Reading 中添加 YouTube 或 Bilibili 链接，可获得原生播放、字幕文本搜索、基于时间戳的辅导、已保存的笔记和可恢复的进度。
知识以带版本的 RAG 库提供，涵盖 LlamaIndex、PageIndex、GraphRAG、LightRAG、远程 LightRAG Server、自托管的 WeKnora 知识库、腾讯 IMA 或 MarginNote 4 资料库、已连接的 Kiwix ZIM 归档或已链接的 Obsidian 库，并支持可插拔的文档解析。
扩展能力包括内置工具、MCP 服务器、CLI 应用、图像/视频/语音生成模型，以及来自 EduHub 的可安装社区技能。
在 DeepTutor 的个性化记忆中，L1 追踪、L2 表层摘要和 L3 综合使个性化可见且可编辑。

怎么上手

DeepTutor 提供四种安装路径。
选项 1，即通过 PyPI 安装完整本地 Web 应用和 CLI，需要 Python 3.11–3.14，以及 PATH 上的 Node.js 20+ 运行时，因为打包的 Next.js standalone 服务器由 deeptutor start 启动。
跳过初始化可用于快速试用；应用以默认端口和空的模型设置启动，之后可在 Settings → Providers 和 Language models 中配置。

摘自 README · bash

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

摘自 README · bash

mkdir -p my-deeptutor && cd my-deeptutor
pip install -U "deeptutor[full]"
deeptutor init     # prompts for ports + LLM provider + optional embedding/search
deeptutor start    # starts backend + frontend; keep the terminal open

摘自 README · bash

git clone --branch dev https://github.com/HKUDS/DeepTutor.git
cd DeepTutor

# Create a venv (macOS/Linux). Windows PowerShell:
#   py -3.11 -m venv .venv ; .\.venv\Scripts\Activate.ps1
python3 -m venv .venv && source .venv/bin/activate
python -m pip install --upgrade pip

# Install backend + frontend deps
python -m pip install -r requirements/full.txt
python -m pip install -e . --no-deps
( cd web && npm ci --legacy-peer-deps )

deeptutor init
deeptutor start --dev