MCPcopy
hub / github.com/HKUDS/DeepTutor

github.com/HKUDS/DeepTutor @v1.4.15 sqlite

repository ↗ · DeepWiki ↗ · release v1.4.15 ↗
12,379 symbols 53,460 edges 1,288 files 3,023 documented · 24%
README

DeepTutor logo DeepTutor

DeepTutor: Agent-Native Personalized Tutoring

Docs — deeptutor.info

HKUDS%2FDeepTutor | Trendshift

English  简体中文  日本語  Español  Français  Arabic  Русский  Hindi  Português  Thai  Polski

Python 3.11+ Next.js 16 License GitHub release arXiv

Discord Feishu WeChat

Features · Get Started · Explore · CLI · Ecosystem · Community


🤝 We welcome any kinds of contributing! Vote on roadmap items or propose new ones at Roadmap, and see our Contributing Guide for branching strategy, coding standards, and how to get started.

📦 Releases

[2026.6.30] 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 — 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 — 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 — A new LightRAG Server retrieval engine, a lightweight PyMuPDF4LLM parsing engine, and a FAISS vector backend that makes large knowledge-base retrieval dramatically faster.

Past releases (more than 1 week ago)

[2026.6.23] 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 — 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 — 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 — 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 — 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 — 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 — 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 — Install community skills from ClawHub 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 — 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 — 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 — 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 — 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 — 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 — 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 — TutorBot Zulip and NVIDIA NIM support, safer thinking-model routing, deeptutor start, sidebar tooltips, and session-store parity.

[2026.5.8] 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 — Thinking-model/provider fixes, visible Knowledge index history, and safer Co-Writer clear/template editing.

[2026.5.3] 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 — Smoother local launch settings, safer RAG queries, cleaner local embedding auth, and Settings dark-mode polish.

[2026.5.1] 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 — 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 — 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 — Stability: safer RAG routing & embedding validation, Docker persistence, IME-safe input, Windows/GBK robustness.

[2026.4.27] 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 — Persistent chat attachments with file-preview drawer, attachment-aware capability pipelines, TutorBot Markdown export.

[2026.4.25] v1.2.4 — Text/code/SVG attachments, one-command Setup Tour, Markdown chat export, compact KB management UI.

[2026.4.24] 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 — User-authored Skills system, chat input performance overhaul, TutorBot auto-start, Book Library UI, visualization fullscreen.

[2026.4.21] v1.2.1 — Per-stage token limits, Regenerate response across all entry points, RAG & Gemma compatibility fixes.

[2026.4.20] v1.2.0 — Book Engine "living book" compiler, multi-document Co-Writer, interactive HTML visualizations, Question Bank @-mention.

[2026.4.18] v1.1.2 — Schema-driven Channels tab, RAG single-pipeline consolidation, externalized chat prompts.

[2026.4.17] v1.1.1 — Universal "Answer now", Co-Writer scroll sync, unified settings panel, streaming Stop button.

[2026.4.15] v1.1.0 — LaTeX block math overhaul, LLM diagnostic probe, Docker + local LLM guidance.

[2026.4.14] v1.1.0-beta — Bookmarkable sessions, Snow theme, WebSocket heartbeat & auto-reconnect, embedding registry overhaul.

[2026.4.13] 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 — Search consolidation with SearXNG fallback, provider switch fix, and frontend resource leak fixes.

[2026.4.10] v1.0.1 — Visualize capability (Chart.js/SVG), quiz duplicate prevention, and o4-mini model support.

[2026.4.10] 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 — 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

Extension points exported contracts — how you extend this code

PickerRow (Interface)
Normalized picker row — an imported conversation OR a connected partner's * session. The shared shape lets one set of
web/components/chat/MyAgentsPicker.tsx
StorageWrapper (Interface)
* Storage wrapper interface for storing versioned data
web/lib/persistence.ts
ContentTypeOption (Interface)
* Each chapter declares a *content type* — a hint to the SectionArchitect * about what kind of block sequence to plan (
web/app/(workspace)/book/components/SpineEditor.tsx
FileSystemHandle (Interface)
(no doc)
web/types/file-system-access.d.ts
OutgoingAttachment (Interface)
(no doc)
web/context/UnifiedChatContext.tsx
SmoothStreamOptions (Interface)
(no doc)
web/hooks/useSmoothStreamText.ts
SessionLoadingViewProps (Interface)
* Indeterminate loading overlay shown while a chat session is fetched from * the server (e.g. when opening an entry fro
web/components/chat/home/SessionLoadingView.tsx
PickerOrigin (Interface)
* Tiny module-level handoff for "expand from the clicked element" picker * animations. * * When a menu row that opens
web/lib/picker-origin.ts

Core symbols most depended-on inside this repo

t
called by 2526
deeptutor/core/i18n.py
get
called by 2460
deeptutor/book/blocks/base.py
str
called by 2250
web/components/memory/MemoryRunPanel.tsx
get
called by 1593
deeptutor/services/memory/consolidator/runs.py
append
called by 1446
deeptutor/services/partners/sessions.py
map
called by 582
deeptutor/capabilities/solve/session.py
exists
called by 447
deeptutor/learning/storage.py
filter
called by 282
deeptutor/api/main.py

Shape

Function 6,080
Method 4,227
Class 1,301
Interface 461
Route 310

Languages

Python83%
TypeScript17%

Modules by API surface

deeptutor/api/routers/knowledge.py140 symbols
tests/services/partners/test_zulip_channel.py134 symbols
deeptutor/api/routers/settings.py109 symbols
deeptutor/api/routers/partners.py100 symbols
deeptutor/services/session/sqlite_store.py95 symbols
deeptutor/agents/research/pipeline.py93 symbols
tests/services/partners/test_napcat_channel.py75 symbols
deeptutor/agents/question/pipeline.py73 symbols
tests/api/test_knowledge_router.py72 symbols
deeptutor/services/config/runtime_settings.py71 symbols
deeptutor/services/path_service.py69 symbols
deeptutor/api/routers/memory.py69 symbols

Dependencies from manifests, versioned

@playwright/test1.53.2 · 1×
@types/node25 · 1×
@types/react19 · 1×
@types/react-dom19 · 1×
@types/react-syntax-highlighter15.5.13 · 1×
autoprefixer10.4.20 · 1×
chart.js4.5.1 · 1×
clsx2.1.1 · 1×
cytoscape3.33.1 · 1×
docx-preview0.3.7 · 1×
eslint9 · 1×
eslint-config-next16.2.3 · 1×

For agents

$ claude mcp add DeepTutor \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact