LaunchedEditorial Listing

DeepTutor

HKUDS (Data Intelligence Lab@HKU) · DeepTutor: Open-Source, Self-Hosted AI Tutor with Mastery Paths, Knowledge-Base RAG, and Inspectable Memory

Open DeepTutor

DeepTutor is a free, Apache-2.0 personal tutoring agent you run on your own machine: it teaches from your documents and the web through chat, quizzes, worked solutions, cited research reports, mastery paths, and interactive books, and keeps a memory of you that you can read and edit. It suits self-learners, students, and technical teachers or labs who are comfortable running a Python or Docker app with their own model provider.

PricingFree
Setupmedium
Runs onSelf-hosted
APIYes
Open sourceYes
DocsYes
CategoryResearch
AI TutorEducationOpen SourceSelf-HostedKnowledge BaseRAGDeep ResearchPersistent MemoryModel-AgnosticLocal ModelsMCPAgent SkillsCLIPython

Best for

Self-learners, students, and technically comfortable teachers or research labs who want a free, self-hosted tutor that teaches from their own documents, tracks mastery, and keeps an auditable memory, using whichever model provider or local model they choose

Not ideal for

Schools or families that need a managed, supported service with accounts out of the box, people who want a mobile app or zero-setup study tool, and anyone unwilling to run Python or Docker and manage model and embedding keys

Who it's for

Self-learners, students, educators, and research groups who want an open-source, self-hosted AI tutor grounded in their own materials

Capabilities

  • One agent runtime behind every mode: Chat, Ask Questions, Quiz, Solve, Deep Research, Visualize, Course Study, Mastery Path, Immersive Reading, and Audio Overview share session context, tools, and knowledge bases
  • Chat tools you can toggle (web search, paper search, Zotero search, reasoning, GeoGebra analysis, image and video generation) plus contextual tools for retrieval, memory, notebooks, the question bank, GitHub, and workspace files, with an ask_user pause instead of guessing
  • Mastery Path: turns a goal and your materials into modules of typed knowledge points (memory, procedure, concept, design), examines you in Study and Review modes, grades grouped answers independently, and schedules spaced review
  • Immersive Reading for PDFs, EPUBs, and YouTube or Bilibili videos, with citations to the page or timestamp, saved notes, read-aloud, and resumable progress
  • Book: compiles knowledge bases, notebooks, question banks, or chat history into an editable living book of typed blocks (text, quizzes, flash cards, timelines, code, figures, interactive HTML, concept graphs) with per-page chat and Markdown export
  • Knowledge Center with a choice of retrieval engines per knowledge base (LlamaIndex, PageIndex, GraphRAG, LightRAG, LightRAG Server, WeKnora, Tencent IMA, MarginNote 4, Kiwix archives, or a linked Obsidian vault), versioned re-indexing, GitHub and documentation-site sync, and `deeptutor kb eval` retrieval scoring
  • Three-layer, file-backed memory (L1 traces, L2 per-surface facts, L3 synthesis) shown in a Memory Graph that links each fact to its evidence, so personalization can be audited and edited
  • Partners: persistent tutors with their own persona, library, and memory, reachable over Telegram, Slack, Discord, Feishu, DingTalk, QQ, WeCom, WeChat, WhatsApp, Zulip, Mattermost, Matrix, Microsoft Teams, and email
  • My Agents: consult a live Claude Code, Codex, Grok CLI, Antigravity, Kimi, opencode, MiMo, Hermes, OpenClaw, or DeepSeek harness from inside a chat turn, and import ChatGPT, Claude Code, or Codex history as searchable conversations
  • Agent-friendly interfaces: `deeptutor run` with NDJSON output, a root SKILL.md for coding agents, and a FastAPI backend with an OpenAPI spec and a turn WebSocket
  • Extensible with MCP services, CLI apps, installable Agent Skills from the EduHub and ClawHub registries behind an import safety gate, and CLI-managed plugins with permission approval and rollback
  • Optional multi-user mode with an admin, isolated per-user workspaces, per-user grants for models, knowledge bases, and tools, and learner and guardian roles with reports and material approval

Limitations

  • Self-hosted only: the maintainers state they have no paid online products of any kind, so there is no managed service, support plan, or hosted trial
  • Needs Python 3.11 to 3.14 plus Node.js 20 or newer for the PyPI install, or Docker, and an LLM provider key or a local model server; knowledge bases also need a separately configured embedding model
  • Authentication is off by default and the app runs single-user until you enable it, so a deployment reachable by others must be secured first
  • Model-written code for the office skills runs in a sandbox only when a runner sidecar or Linux bubblewrap is available; otherwise it falls back to a restricted subprocess that the settings label best effort
  • Very fast release pace (several releases a month in 2026, including a breaking front-end and back-end refactor in v1.6.3), and README screenshots lag behind the current interface
  • Signing in with a ChatGPT plan through OpenAI Codex OAuth is labeled experimental, and remote deployments need an SSH tunnel to complete that sign-in
  • Some extras carry their own requirements: the GraphRAG engine supports Python 3.11 to 3.13, the math animator needs LaTeX and FFmpeg, and the CLI-only package is installed from a source checkout rather than PyPI
  • No integration with learning management systems such as Moodle or Canvas is documented

Use cases

  • Building a knowledge base from a textbook PDF and asking the tutor to explain a chapter, then quizzing yourself on it
  • Setting a goal such as learning linear algebra and working through a Mastery Path that only advances when you pass its checks
  • Reading a paper or watching a lecture video with the tutor citing exact pages or timestamps as you ask questions
  • Generating a cited Deep Research report on a topic and turning it into a quiz in the same session
  • Running a study partner on Telegram, Feishu, or Slack that remembers what you have covered
  • Letting Claude Code or Codex call DeepTutor from the terminal to quiz you or research a topic, with machine-readable output

Our take

DeepTutor is less a chatbot than a self-hosted study environment: one agent loop drives tutoring, quizzes, research, reading, and a Mastery Path that only moves forward when an assessment says you have learned the point. Two choices stand out. Memory is a set of files you can open and audit, not an opaque profile, and the tutor can be reached from IM apps or driven by other agents. That suits learners and labs who want control over models and data. The cost is operational. You install, configure, and keep updating a fast-moving project with a very large settings surface, and quality depends on the chat and embedding models you pick. Start with the Docker trial and one knowledge base before turning on Partners or multi-user mode.

Who should use it

Self-learners and students who want a tutor grounded in their own textbooks, papers, and videos with real progress tracking; teachers, tutors, and research groups who want to host one instance for several learners with isolated workspaces; and developers who want a learning backend that Claude Code, Codex, or their own agents can call.

Who should skip it

People who want a polished hosted app or mobile study tool with no setup, institutions that need vendor support, published terms, or LMS integration, and anyone who does not want to run Python or Docker or manage model API keys.

Strengths

  • Free and Apache-2.0 licensed, with no paid tier or account
  • Covers the whole study loop in one place: explanations, worked solutions, quizzes, cited research, reading, books, and mastery tracking
  • Mastery Path advances on assessed understanding rather than time spent
  • Memory is file-backed and visible, so you can see and correct what the tutor believes about you
  • Works with dozens of hosted providers or fully local models, and many retrieval engines
  • Reachable from IM apps, coding agents, the CLI, and an API, not only the web app

Weaknesses

  • Self-hosted only, with no managed service or support
  • Large surface area and many settings to configure before it works well
  • Retrieval needs an embedding model in addition to the chat model
  • Releases every few days, including breaking refactors
  • Single-user and unauthenticated by default

DeepTutor pricing

Open Source

Free

  • Apache-2.0 license
  • Install from PyPI, from source, or as a Docker container, or use the CLI-only build
  • Bring your own LLM, embedding, and search providers, or run local models

Free tier limits: All features are free. Web search works without a key through DuckDuckGo by default, and local providers such as Ollama need no API key.

Note: There is no hosted or paid plan; the maintainers state they have no paid online products of any form. Costs come from the model, embedding, search, speech, and generation providers you configure, or only your hardware with local models. An existing ChatGPT plan (through the experimental OpenAI Codex sign-in) or a GitHub Copilot subscription with model access can be used instead of a separate API key; these sign-ins are per account and cannot be shared with other users through grants.

Technical specs

Modalities

Text, Documents (PDF, DOCX, XLSX, PPTX, EPUB), Images (with vision-capable models), Video (YouTube and Bilibili transcripts), Voice (text-to-speech and speech-to-text), Image and video generation

API pricing

Free local FastAPI backend (`deeptutor serve`) with an OpenAPI spec and turn WebSocket, plus NDJSON output from the CLI; model usage is billed by the provider you connect

Available models

OpenAI, Anthropic, Google Gemini, Azure OpenAI, DeepSeek, Mistral, Groq, OpenRouter, Qwen (DashScope), Kimi (Moonshot), Zhipu GLM, MiniMax, SiliconFlow, NVIDIA NIM, and other listed providersGitHub Copilot through device login, and OpenAI Codex through ChatGPT sign-in (experimental)Any OpenAI-compatible endpointLocal models through Ollama, LM Studio, llama.cpp, vLLM, Lemonade, or OpenVINO Model Server

Where DeepTutor excels

Studying a course from your own textbook

You build a knowledge base from the PDF, then use a Mastery Path that splits the goal into knowledge points, examines you on each, and schedules spaced review, while Chat and Solve explain anything you get wrong with citations to the source.

A tutor for a small class or family on one server

With authentication enabled, an admin shares models and knowledge bases while each learner keeps an isolated workspace and memory, and guardian accounts can review reports and approve materials.

Learning tools for a coding agent

Claude Code or Codex can call `deeptutor run` with JSON output to research a topic and then quiz you on it in the same session, so learning fits into a terminal workflow.

DeepTutor vs. competitors

DeepTutor vs. Gemini Notebook (formerly NotebookLM)

Gemini Notebook (formerly NotebookLM) is Google's hosted research assistant: you add sources and it answers with citations and generates study aids such as audio overviews, flashcards, and quizzes, with a free tier and no setup. DeepTutor covers similar ground on your own machine and goes further on teaching: Mastery Paths with assessed progress, worked solutions, living books, an editable memory of the learner, IM-based tutors, and a choice of models and retrieval engines. Pick Gemini Notebook for quick, zero-setup study from sources, and DeepTutor if you want a tutor you host and control.

DeepTutor vs. OpenMAIC

OpenMAIC (MIT, Tsinghua University) turns a topic or your materials into a generated classroom: narrated slides, simulations, and project-based activities taught by multiple AI teachers and classmates, with exports to PowerPoint and HTML. DeepTutor (Apache-2.0, HKU) is organized around one learner over time: chat-based tutoring, quizzes, research, reading, and Mastery Paths over your knowledge bases, with persistent memory. Pick OpenMAIC to produce or sit through interactive lessons, and DeepTutor for an ongoing personal tutor and study workspace.

Frequently asked questions

What is DeepTutor?

DeepTutor is an open-source, self-hosted AI tutor from the HKUDS group at the University of Hong Kong. One agent runtime powers chat tutoring, quizzes, worked solutions, cited research reports, reading with page or timestamp citations, interactive books, and Mastery Paths that track what you have actually learned, all grounded in knowledge bases you build from your own materials.

Is DeepTutor free and open source?

Yes. DeepTutor is released under the Apache-2.0 license and installs from PyPI as `deeptutor` or as a Docker image. The maintainers state they have no paid online products, so there is no hosted plan; your only costs are the model, embedding, and search providers you connect, or nothing beyond your hardware with local models.

How do I install DeepTutor?

There are four paths: `pip install -U deeptutor` followed by `deeptutor init` and `deeptutor start` (needs Python 3.11 to 3.14 and Node.js 20 or newer), a single Docker container from ghcr.io/hkuds/deeptutor, a source checkout for development, or a CLI-only build without the web interface. The web app opens at 127.0.0.1:3782 by default, and you configure model providers in Settings.

Which models does DeepTutor support?

The provider catalog includes OpenAI, Anthropic, Google Gemini, Azure OpenAI, DeepSeek, Mistral, Groq, OpenRouter, Qwen, Kimi, Zhipu GLM, MiniMax, SiliconFlow, NVIDIA NIM, and many others, plus any OpenAI-compatible endpoint. GitHub Copilot and an experimental ChatGPT sign-in through OpenAI Codex can replace a separate API key, and Ollama, LM Studio, llama.cpp, vLLM, and Lemonade run models locally without one.

Can other AI agents use DeepTutor?

Yes. `deeptutor run` with `--format json` streams one NDJSON event per line for scripts and agents, the repository ships a SKILL.md handover for coding agents such as Claude Code and Codex, and `deeptutor serve` exposes a FastAPI backend with an OpenAPI spec. In the other direction, DeepTutor's My Agents feature can consult a live Claude Code, Codex, or other coding-agent CLI from inside a chat turn.

Can several students share one DeepTutor server?

Yes, once you enable authentication, which is off by default. The first registered user becomes the admin and controls models, credentials, and shared knowledge bases; other users get isolated workspaces and only the models, knowledge bases, and tools they are granted. Learner accounts have locked learning capabilities and material policies, and authorized guardians can view reports, approve materials, and reset credentials.

DeepTutor vs Gemini Notebook: what is the difference?

Gemini Notebook is a hosted Google service that answers questions about your sources with citations and generates study aids, with no setup. DeepTutor is self-hosted and open source, lets you choose the model and retrieval engine, and adds teaching features such as Mastery Paths with assessed progress, worked solutions, living books, an inspectable learner memory, and tutors you can reach over IM apps.

Integrations & fit

OpenAIAnthropicGoogle GeminiAzure OpenAIDeepSeekOpenRouterGroqMistralQwen (DashScope)Kimi (Moonshot)Zhipu GLMMiniMaxSiliconFlowNVIDIA NIMGitHub CopilotOpenAI CodexOllamaLM Studiollama.cppvLLMLemonadeClaude CodeCodexOpenClawMCPLlamaIndexLightRAGGraphRAGPageIndexObsidianZoteroMarginNote 4KiwixYouTubeBilibiliGeoGebraBrave SearchTavilySearXNGDuckDuckGoTelegramSlackDiscordFeishuWeComWhatsAppMicrosoft TeamsDocker
Good fit forSolo / individual, Startup / small team
Pricing modelFree· No cost to start
See pricing on DeepTutor →

Alternatives to consider

About DeepTutor

DeepTutor is an open-source learning workspace from the HKUDS group (the Data Intelligence Lab at the University of Hong Kong), first released at the end of 2025 and rebuilt in 2026 around a single agent loop. You install it from PyPI (`pip install deeptutor`), from source, or as one Docker container, run `deeptutor init` to pick a model provider, and open a local web app; a CLI-only build is available for headless use. Every mode runs on the same runtime and session context: Chat (an agent that calls tools such as web, paper, and Zotero search, retrieval over your knowledge bases, GeoGebra analysis, and code execution), Ask Questions, Quiz, Solve for step-by-step reasoning, Deep Research for cited reports, Visualize, Course Study, Audio Overview, Immersive Reading for PDFs, EPUBs, and YouTube or Bilibili videos with page- or timestamp-grounded tutoring, and Mastery Path, which turns a goal into modules of typed knowledge points and only advances when an assessment, or your explicit declaration, says you have mastered a point, with spaced review later. Book compiles knowledge bases and notebooks into an editable living book with quizzes, flash cards, figures, and per-page chat, and Co-Writer is a selection-aware Markdown editor. Knowledge bases can use LlamaIndex, PageIndex, GraphRAG, LightRAG, or a linked Obsidian vault, among other engines, and can follow GitHub repositories or documentation sites. Memory is a three-layer, file-backed system (event traces, per-surface facts, cross-surface synthesis) that you can inspect in a graph rather than a hidden vector store. Beyond the web app, Partners are persistent tutors on the same brain that you can reach over Telegram, Slack, Discord, Feishu, WeCom, WhatsApp, Microsoft Teams, and other IM channels; My Agents lets a chat turn consult a live Claude Code, Codex, or other coding-agent CLI on your machine; and other agents can drive DeepTutor through its CLI's NDJSON output or its FastAPI backend. Optional multi-user mode adds admin, learner, and guardian roles with isolated workspaces. The maintainers state they have no paid online products, so there is no hosted version: you pay only for the model and search providers you connect, or nothing beyond hardware with local models. The tradeoffs are setup and pace. You run and update the service yourself, retrieval needs a separately configured embedding model, the surface is very large, and releases arrive every few days.

Updates from DeepTutor

New FeatureDeepTutor v1.6.15 adds grouped assessments and bounded tutoring memory

v1.6.15 lets you preview learning-path changes before applying them, has the tutor present two to four questions as a group and grade each answer independently, and keeps teaching preferences and unresolved misunderstandings in bounded memory during long sessions. It also adds an optional query-rewrite layer with retrieval comparisons in `deeptutor kb eval`, native Gemini speech, and an optional request-screening extra.

New FeatureDeepTutor v1.6.14 adds source-figure practice and research tools

v1.6.14 lets you ask about an exact figure, table, or PDF page in a knowledge base, makes indexing recoverable, moves YouTube and Bilibili learning into Reading, adds tools for reading versioned arXiv papers and checking paper claims against a pinned GitHub revision, and introduces a reviewed plugin lifecycle in the CLI.

New FeatureDeepTutor v1.6.12 adds Kiwix archives and a Task Board

v1.6.12 lets each workspace place and move its knowledge bases, connects searchable Kiwix ZIM archives without indexing a copy, carries source figures into grounded answers for vision-capable models, and adds a workspace Task Board and a German interface.

Are you the founder? Claim this listing →