DeepTutor
DeepTutor

Personal tutoring,
reimagined.

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

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

Eight surfaces, one running context.

Chat, Partners, Co-Writer, Book, Knowledge, Space, Memory, and Settings share the same agent-native runtime. Switching surfaces no longer means losing your place.

I

Chat

The default agent loop: tools, RAG, attachments, notebook writes, memory, and deeper capabilities in one session.

 II

Partners

Persistent companions with their own soul, library, model policy, tools, and IM channels — powered by the same chat loop.

 III

Co-Writer

A selection-aware Markdown workspace where AI edits can be grounded in your knowledge base or the web.

 IV

Book Engine

Compile knowledge bases, notebooks, question assets, and chat history into interactive living books.

 V

Knowledge

LlamaIndex-backed, versioned document libraries for RAG, Chat, Co-Writer, Book, and Partners.

 VI

Space

Reusable context assets: skills, personas, notebooks, chat history, and question material.

 VII

Memory

Inspectable personalization through L1 traces, L2 facts, L3 synthesis, and a Memory Graph.

 VIII

Settings

The control plane for models, embeddings, search, tools, MCP, capabilities, network, and memory.
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; add Partners extras when needed.

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 Web UI. Embeddings stay off by default; add extras for RAG or Partner channels. Full guide