close
DeepTutor
DeepTutor

Personal tutoring,
reimagined.

Agent-native Learning Companion that grows with you.
Fully Open-Sourced.

Docs GitHub — Stars
Apache 2.0 · From HKU Data Intelligence Lab
DeepTutor — Chat Workspace
DeepTutor chat workspace — Chat / TutorBot / Co-Writer / Book / Knowledge / Space / Memory in the sidebar; greeting and composer in the main area.
What's inside

Six pillars, one running context.

Every surface reads from — and writes back to — the same memory, knowledge base, and tutor. Switching contexts no longer means losing your place.

I

Chat Workspace

Five modes — Chat, Solve, Quiz, Research, Visualize — share one session, knowledge base, and citation history. Escalate mid-thread without losing context.

 II

Co-Writer

A split-view Markdown workbench where AI is a first-class collaborator. Select, rewrite, expand — grounded in your knowledge base.

 III

Book Engine

A multi-agent pipeline compiles your materials into interactive living books — 13 block types, including a GeoGebra viewer and animations.

 IV

Knowledge

Versioned RAG-ready document libraries on LlamaIndex end-to-end. Every (re-)index is tracked, comparable, and rollback-able.

 V

Space

Your personal library — chat history, notebooks, question bank, and authored skills. The read-and-review counterpart to every active surface.

 VI

Memory

Append-only L1 traces, L2 curated facts with citations, L3 cross-surface synthesis. A Memory Graph lets you audit why DeepTutor knows what it knows.
Install

Up and running in minutes.

Four ways to install — pick the one that fits. Every path lands at the same configured workspace.

Smoothest path. Full local Web app + CLI, no clone required.

# 1. Create a workspace directory
mkdir -p my-deeptutor && cd my-deeptutor

# 2. Install, configure, launch
pip install -U deeptutor
deeptutor init
deeptutor start
Then open 127.0.0.1:3782 Full guide

One container for the full Web app, from GitHub Container Registry.

docker run --rm --name deeptutor \
  -p 127.0.0.1:3782:3782 \
  -p 127.0.0.1:8001:8001 \
  -v deeptutor-data:/app/data \
  ghcr.io/hkuds/deeptutor:latest
Map both 3782 (UI) and 8001 (API). Data persists in the named volume. Full guide

Hot-reload the frontend, hack on the backend, match CI exactly.

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor

python3 -m venv .venv && source .venv/bin/activate
pip install -e .
( cd web && npm ci --legacy-peer-deps )

deeptutor init && deeptutor start
Python 3.11+ · Node.js 22 LTS. Next.js runs in dev mode against ./web. Full guide

Lightweight install for servers, agent harnesses, Claude Code / Codex setups.

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor

python3 -m venv .venv-cli && source .venv-cli/bin/activate
pip install -e ./packaging/deeptutor-cli

deeptutor init --cli
deeptutor chat
No backend / frontend ports. Embeddings off by default — opt in for RAG. Full guide