What do you want to do?
3 use cases
-
Try the full Deep Tutor web app in one Docker command
Run the published image, open the web app and configure a provider and model.
- REPO
HKUDS/DeepTutor - Research
- Beginner
View prompt
Start DeepTutor with Docker using the ghcr.io/hkuds/deeptutor:latest image on 127.0.0.1:3782 with a deeptutor-data volume, then tell me which Settings, Providers fields I need for <provider>.
- REPO
-
Install the Deep Tutor web app and CLI with pip
Use the PyPI package, run the setup wizard and start backend and frontend together.
- REPO
HKUDS/DeepTutor - Claude Code
- Codex
- Research
- Beginner
View prompt
Install DeepTutor with `python -m pip install -U "deeptutor[full]"` in a new my-deeptutor folder, run `deeptutor init` with <provider>, then `deeptutor start`, and confirm the web app opens.
- REPO
-
Score which retrieval setup works best on your knowledge base
Write a small QA set and run deeptutor kb eval to get Recall, Precision, nDCG and MRR.
- REPO
HKUDS/DeepTutor - Claude Code
- Codex
- Research
- Advanced
View prompt
For my DeepTutor knowledge base <name>, write 10 QA cases from these documents as qa.jsonl, run `deeptutor kb eval` with --top-k 5 and --save baseline.json, and summarize Recall@k and MRR.
- REPO
What people are building with Deep Tutor
-
BenchmarkX
Ran DeepTutor on a laptop with a 4B local model and no API key
They tested DeepTutor locally with a 4B model and no API key and got 3 of 4 test questions right, with one miss.
By Prompt Engineer 48 (@prompt48)
Real builds shared on X, Hacker News, Reddit, DEV and GitHub, summed up by Deduped from each post and its links; each card links to the original post. See what people are building with other repos
Quick start with Deep Tutor
- Check you have what it needs: Docker, or Python 3.11 to 3.14 with Node.js 20.9+ for the PyPI web app; An LLM provider and model configured in Settings, Providers; Optional embedding and search providers for knowledge bases.
- Open HKUDS/DeepTutor on GitHub and read the README and license.
- Run the
docker run --rm --name deeptutorcommand from the README, publishing 127.0.0.1:3782:3782 with the deeptutor-data volume and ghcr.io/hkuds/deeptutor:latest - Open http://127.0.0.1:3782
- Configure a provider and model in Settings, Providers and Language models
- Create a workspace for a subject and start in Chat
These steps come from our top use case, Try the full Deep Tutor web app in one Docker command, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for HKUDS/DeepTutor
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forStudents, self-learners and teachers who want an AI tutor that works over their own material.
- Why it is hot+7,512 stars this week, 55k total
- LanguagePython
- Sourcegithub.com/HKUDS/DeepTutor · Back to Hot repos
Requirements
- Docker, or Python 3.11 to 3.14 with Node.js 20.9+ for the PyPI web app
- An LLM provider and model configured in Settings, Providers
- Optional embedding and search providers for knowledge bases
Add this badge to your README
Maintain Deep Tutor? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/hkuds-deeptutor/?utm_source=github&utm_medium=badge&utm_campaign=HKUDS-DeepTutor)
HTML
<a href="https://dedupedai.com/use-cases/hkuds-deeptutor/?utm_source=github&utm_medium=badge&utm_campaign=HKUDS-DeepTutor"><img src="https://dedupedai.com/badge/HKUDS/DeepTutor.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Deep Tutor
What is Deep Tutor?
DeepTutor is an open-source, agent-native tutoring workspace for lifelong personalized learning. Chat, Quiz, Research, Visualize, Solve, Mastery Path and Reading share session context inside a workspace per subject, with knowledge bases, notebooks, a Question Bank and partners that can consult live agents such as Claude Code and Codex. It runs as a Web app and CLI from Docker, PyPI or source. It is an open-source project on GitHub: https://github.com/HKUDS/DeepTutor.
How do I use Deep Tutor?
Run the docker run --rm --name deeptutor command from the README, publishing 127.0.0.1:3782:3782 with the deeptutor-data volume and ghcr.io/hkuds/deeptutor:latest; then open http://127.0.0.1:3782; configure a provider and model in Settings, Providers and Language models. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is Deep Tutor for?
Students, self-learners and teachers who want an AI tutor that works over their own material.
What can I do with Deep Tutor?
3 use cases so far, for example: Try the full Deep Tutor web app in one Docker command; Install the Deep Tutor web app and CLI with pip; Score which retrieval setup works best on your knowledge base. Each has steps and a copy-paste agent prompt.
What do I need to run Deep Tutor?
Docker, or Python 3.11 to 3.14 with Node.js 20.9+ for the PyPI web app; An LLM provider and model configured in Settings, Providers; Optional embedding and search providers for knowledge bases.
What are alternatives to Deep Tutor?
Other hot AI repos in Research: Local Deep Research, Project Nomad, Nanochat, We Knora, OpenMAIC.
Is Deep Tutor safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.