This project called DeepTutor is positioned as a “lifelong learning” personalized tutoring platform, developed by the HKU Data Intelligence Lab (HKUDS) team, and has received over 27,000 stars on GitHub. Its core design idea is to provide an “agent-native” learning workspace, rather than a simple Q&A bot. It attempts to achieve long-term personalized tutoring through several key mechanisms:

• Persistent learning context: The system designs a knowledge base, books, notes, question bank, and memory system. These components can be shared across different workflows such as chat, problem solving, question generation, and research, aiming for the AI to “remember” the learner’s previous progress and content.

• Traceable personalized memory: It implements a three-layer memory system (L1 trace layer, L2 fact layer, L3 synthesis layer) and provides a “memory graph” for visual traceability. Any personalized conclusion given by the AI can theoretically be traced back to the original learning interaction records, increasing explainability.

• Flexible deployment and integration: The project offers multiple installation methods, including PyPI package, source code, Docker, and pure command-line (CLI) mode. It supports local deployment and also allows integration with local models such as Ollama and LM Studio to protect privacy. Additionally, it supports extending functionality through the “Skill” system and has a built-in community skill marketplace “EduHub”.

• Covers multiple learning scenarios: Besides conversation, it also has built-in capability modules such as “Co-Writer”, “Living Book Generation”, “Deep Research”, “Visualize”, and “Mastery Path”, aiming to cover the full process from knowledge input to practice output.

In summary, DeepTutor is an open-source AI tutoring tool with a relatively complete functional architecture, emphasizing memory and explainability. It attempts to address common problems in AI tutoring such as “lack of continuity in conversations” and “inability to trace the source of suggestions”.

https://github.com/HKUDS/DeepTutor

HKUDS/DeepTutor

Source: https://github.com/HKUDS/DeepTutor

DeepTutor: Lifelong Personalized Tutoring

Python 3.11+ (https://www.python.org/downloads/) Next.js 16 (https://nextjs.org/) License GitHub release (https://github.com/HKUDS/DeepTutor/releases) arXiv (https://arxiv.org/abs/2604.26962) Discord (https://discord.gg/eRsjPgMU4t) Feishu WeChat (https://github.com/HKUDS/DeepTutor/issues/78) Features · Get Started · Explore · CLI · Ecosystem · Community

🤝 We welcome any kinds of contributing! Vote on roadmap items or propose new ones at Roadmap (https://github.com/HKUDS/DeepTutor/issues/498), and see our Contributing Guide for branching strategy, coding standards, and how to get started.

📦 Releases

[2026.7.19] v1.5.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.5.2) — Configurable chat attachment limits, PageIndex retrieval that reasons across your documents via agentic tool calls, broader Anthropic/OpenAI model support, and steadier Book, Knowledge Base, and chat UI.

Past releases (more than 1 week ago)

[2026.7.9] v1.5.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.5.1) — Remove a single failed document from a knowledge base — even one stuck in an error state — instead of deleting and rebuilding the whole base. [2026.7.4] v1.5.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.5.0) — LlamaIndex ingestion now honors your Document Parsing engine with multimodal image extraction, Partner & Soul ids stay URL-safe for non-Latin names, and optional RAG extras install cleanly on Python 3.14+. [2026.6.30] v1.4.15 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.15) — A native Mattermost channel for Partners, plus fixes so Guided Learning multiple-choice questions grade correctly and a configured zero chunk overlap is honored. [2026.6.29] v1.4.14 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.14) — Click an assigned partner to chat in one step, Deep Research flags partial reports, LightRAG indexes without MinerU, FAISS handles non-ASCII paths, and PocketBase sessions are isolated per user. [2026.6.27] v1.4.13 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.13) — Partners support non-Latin names and become assignable to users, logos render after login (#599), tiny knowledge bases retrieve reliably, and containers start cleanly under rootless Podman. [2026.6.24] v1.4.12 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.12) — A new LightRAG Server retrieval engine, a lightweight PyMuPDF4LLM parsing engine, and a FAISS vector backend that makes large knowledge-base retrieval dramatically faster. [2026.6.23] v1.4.11 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.11) — Native tool calling on every cloud OpenAI-compatible provider, a redesigned admin Users page, LaTeX in quiz options, an honest session-loading spinner, and configurable container host binding. [2026.6.21] v1.4.10 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.10) — A self-service Profile page with avatars, a rootless-ready container guide with a single-port request-time proxy, and deny-by-default MCP tools for non-admin users. [2026.6.19] v1.4.9 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.9) — Settings polish: Search shows only the fields your provider needs, connection profiles can be renamed and auto-named by provider, and graded Mastery Path questions flow into your Question Bank. [2026.6.18] v1.4.8 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.8) — Connect your own Partners under My Agents and consult them live in chat — answering through their own persona, library and skills — and each Partner gains its own private memory. [2026.6.18] v1.4.7 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.7) — Connect your local Claude Code / Codex and consult it live mid-turn, My Agents graduates to a top-level /agents, and Partner conversations gain branch / resume / delete with a replayable trace. [2026.6.17] v1.4.6 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.6) — Four-surface consolidation: a Space learning dashboard with importable My Agents and top-level Memory, a Knowledge Center with GraphRAG / PageIndex / LightRAG / linked-KB / Obsidian, opened-up Settings, and per-model capability gating. [2026.6.14] v1.4.5 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.5) — Guided Learning rebuilt on the chat agent loop with a hard per-type mastery gate and a /learning dashboard, a new loop-plugin framework, plus Markdown export / save-to-notebook for Partner conversations. [2026.6.13] v1.4.4 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.4) — Install community skills from ClawHub (https://clawhub.ai/) with deeptutor skill install behind a security gate, plus real in-browser DOCX/XLSX previews for knowledge-base files. [2026.6.12] v1.4.3 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.3) — TutorBot becomes Partners on a production-grade IM pipeline (15 channels, live streaming), Chat moves to a single agent loop, real per-user isolation, and a rebuilt Visualize. [2026.5.28] v1.4.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.2) — Stability + polish: Gemini 2.5+ unblocked across Visualize and Chat, auth-routing fix (#485), smooth-streaming chat UX, a Recents sidebar, and Lemonade local-provider support. [2026.5.27] v1.4.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.1) — Security + stability: TutorBot tool sandbox locked down, per-user resource isolation, multimodal image fallback, an HTTP/SSE API for TutorBots, and a v1.4.0 chat regression fix. [2026.5.22] v1.4.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.0) — GA cut of v1.4: Auto Mode, three-layer Memory, agentic Deep Research / Solve / Question, LlamaIndex RAG refactor, Visualize/Animator merge, and restart-safe turn runtime. [2026.5.21] v1.4.0-beta (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.0-beta) — Three-layer Memory workbench (L1/L2/L3), every chat capability rebuilt on a single agentic engine, LlamaIndex-only RAG, and a unified Settings + Capabilities surface. [2026.5.10] v1.3.10 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.10) — Remote Docker CORS recovery, DISABLE_SSL_VERIFY across SDK providers, safer code-block citations, and optional Matrix E2EE add-on. [2026.5.9] v1.3.9 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.9) — TutorBot Zulip and NVIDIA NIM support, safer thinking-model routing, deeptutor start, sidebar tooltips, and session-store parity. [2026.5.8] v1.3.8 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.8) — Optional multi-user deployments with isolated user workspaces, admin grants, auth routes, and scoped runtime access. [2026.5.4] v1.3.7 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.7) — Thinking-model/provider fixes, visible Knowledge index history, and safer Co-Writer clear/template editing. [2026.5.3] v1.3.6 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.6) — Catalog-based model selection for chat and TutorBot, safer RAG re-indexing, OpenAI Responses token-limit fixes, and Skills editor validation. [2026.5.2] v1.3.5 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.5) — Smoother local launch settings, safer RAG queries, cleaner local embedding auth, and Settings dark-mode polish. [2026.5.1] v1.3.4 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.4) — Book page chat persistence and rebuild flows, chat-to-book references, stronger language/reasoning handling, RAG document extraction hardening. [2026.4.30] v1.3.3 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.3) — NVIDIA NIM + Gemini embedding support, unified Space context for chat history/skills/memory, session snapshots, RAG re-index resilience. [2026.4.29] v1.3.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.2) — Transparent embedding endpoint URLs, RAG re-index resilience for invalid persisted vectors, memory cleanup for thinking-model output, Deep Solve runtime fix. [2026.4.28] v1.3.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.1) — Stability: safer RAG routing & embedding validation, Docker persistence, IME-safe input, Windows/GBK robustness. [2026.4.27] v1.3.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.0) — Versioned KB indexes with re-index workflow, rebuilt Knowledge workspace, embedding auto-discovery with new adapters, Space hub. [2026.4.25] v1.2.5 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.5) — Persistent chat attachments with file-preview drawer, attachment-aware capability pipelines, TutorBot Markdown export. [2026.4.25] v1.2.4 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.4) — Text/code/SVG attachments, one-command Setup Tour, Markdown chat export, compact KB management UI. [2026.4.24] v1.2.3 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.3) — Document attachments (PDF/DOCX/XLSX/PPTX), reasoning thinking-block display, Soul template editor, Co-Writer save-to-notebook. [2026.4.22] v1.2.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.2) — User-authored Skills system, chat input performance overhaul, TutorBot auto-start, Book Library UI, visualization fullscreen. [2026.4.21] v1.2.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.1) — Per-stage token limits, Regenerate response across all entry points, RAG & Gemma compatibility fixes. [2026.4.20] v1.2.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.0) — Book Engine “living book” compiler, multi-document Co-Writer, interactive HTML visualizations, Question Bank @-mention. [2026.4.18] v1.1.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.2) — Schema-driven Channels tab, RAG single-pipeline consolidation, externalized chat prompts. [2026.4.17] v1.1.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.1) — Universal “Answer now”, Co-Writer scroll sync, unified settings panel, streaming Stop button. [2026.4.15] v1.1.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.0) — LaTeX block math overhaul, LLM diagnostic probe, Docker + local LLM guidance. [2026.4.14] v1.1.0-beta (https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.0-beta) — Bookmarkable sessions, Snow theme, WebSocket heartbeat & auto-reconnect, embedding registry overhaul. [2026.4.13] v1.0.3 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.3) — Question Notebook with bookmarks & categories, Mermaid in Visualize, embedding mismatch detection, Qwen/vLLM compatibility, LM Studio & llama.cpp support, and Glass theme. [2026.4.11] v1.0.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.2) — Search consolidation with SearXNG fallback, provider switch fix, and frontend resource leak fixes. [2026.4.10] v1.0.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.1) — Visualize capability (Chart.js/SVG), quiz duplicate prevention, and o4-mini model support. [2026.4.10] v1.0.0-beta.4 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.4) — Embedding progress tracking with rate-limit retry, cross-platform dependency fixes, and MIME validation fix. [2026.4.8] v1.0.0-beta.3 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.3) — Native OpenAI/Anthropic SDK (drop litellm), Windows Math Animator support, robust JSON parsing, and full Chinese i18n. [2026.4.7] v1.0.0-beta.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.2) — Hot settings reload, MinerU nested output, WebSocket fix, and Python 3.11+ minimum. [2026.4.4] v1.0.0-beta.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.1) — Agent-native architecture rewrite (~200k lines): Tools + Capabilities plugin model, CLI & SDK, TutorBot, Co-Writer, Guided Learning, and persistent memory. [2026.1.23] v0.6.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.6.0) — Session persistence, incremental document upload, flexible RAG pipeline import, and full Chinese localization. [2026.1.18] v0.5.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.2) — Docling support for RAG-Anything, logging system optimization, and bug fixes. [2026.1.15] v0.5.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.0) — Unified service configuration, RAG pipeline selection per knowledge base, question generation overhaul, and sidebar customization. [2026.1.9] v0.4.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.4.0) — Multi-provider LLM & embedding support, new home page, RAG module decoupling, and environment variable refactor. [2026.1.5] v0.3.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.3.0) — Unified PromptManager architecture, GitHub Actions CI/CD, and pre-built Docker images on GHCR. [2026.1.2] v0.2.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.2.0) — Docker deployment, Next.js 16 & React 19 upgrade, WebSocket security hardening, and critical vulnerability fixes.

📰 News

• 2026-05-22 🌐 Official docs site live at deeptutor.info (https://deeptutor.info/) — guides, references, and capability tours in one place.
• 2026-04-19 🎉 20k stars in 111 days! Thank you for the support toward truly personalized, intelligent tutoring.
• 2026-04-10 📄 Our paper is live on arXiv — read the preprint (https://arxiv.org/abs/2604.26962) for the design and ideas behind DeepTutor.
• 2026-02-06 🚀 10k stars in just 39 days! A huge thank you to our incredible community.
• 2026-01-01 🎊 Happy New Year! Join our Discord (https://discord.gg/eRsjPgMU4t), WeChat (https://github.com/HKUDS/DeepTutor/issues/78), or Discussions (https://github.com/HKUDS/DeepTutor/discussions) — let’s shape DeepTutor together.
• 2025-12-29 🎓 DeepTutor is officially released!

✨ Key Features

DeepTutor is an agent-native learning workspace that connects tutoring, problem solving, quiz generation, research, visualization, and mastery practice in one extensible system.

• One runtime for every mode — Chat, Quiz, Research, Visualize, Solve, and Mastery Path run on the same agent loop, so you switch the objective, not the engine, and context moves with the learner.
• Connected learning context — Knowledge bases, books, Co-Writer drafts, notebooks, question banks, personas, and Memory stay available across every workflow instead of living in isolated tools.
• Subagents and Partners — consult a live Claude Code, Codex, or Partner from any turn (or import their past conversations), and run persistent IM companions on the same brain.
• Multi-engine knowledge — versioned RAG libraries across LlamaIndex, PageIndex, GraphRAG, LightRAG, or a linked Obsidian vault, with pluggable document parsing.
• Extensible tools and skills — built-in tools, MCP servers, image / video / voice generation models, and installable community skills from EduHub.
• Inspectable memory — L1 traces, L2 surface summaries, and L3 synthesis make personalizati