DeepTutor: AI-Powered Personalized Learning Assistant

Quick Start · Core Modules · FAQ

🇨🇳 中文 · 🇯🇵 日本語 · 🇪🇸 Español · 🇫🇷 Français · 🇸🇦 العربية · 🇷🇺 Русский · 🇮🇳 हिन्दी · 🇵🇹 Português

</div> <div align="center">

📚 Massive Document Knowledge Q&A • 🎨 Interactive Learning Visualization<br> 🎯 Knowledge Reinforcement • 🔍 Deep Research & Idea Generation

</div>

📰 News

[2026.1.1] Happy New Year! Join our Discord Community, Wechat Community, or Discussions - shape the future of DeepTutor! 💬

[2025.12.30] Visit our Official Website for more details!

[2025.12.29] DeepTutor is now live! ✨

📦 Releases

[2026.1.23] Release v0.6.0 - Frontend session persistence, full Chinese support, Docker deployment updates, and minor bug fixes -- Thanks for all the feedback!

<details> <summary>History releases</summary>

[2026.1.18] Release v0.5.2 - Enhance RAG pipeline with Docling support and improve CI/CD workflows with several minor bugs fixed -- Thanks to all the feedbacks!

[2026.1.15] Release v0.5.0 - Unified LLM & Embedding services, RAG pipeline selection, and major enhancements to Home, History, QuestionGen & Settings modules -- Thanks to all the contributors!

[2026.1.9] Release v0.4.1 with LLM Provider system overhaul, Question Generation robustness improvements, and codebase cleanup - Thanks to all the contributors!

[2026.1.9] Release v0.4.0 with new code structure, multiple llm & embeddings support - Thanks to all the contributors!

[2026.1.5] v0.3.0 - Unified PromptManager architecture, CI/CD automation & pre-built Docker images on GHCR

[2026.1.2] v0.2.0 - Docker deployment, Next.js 16 & React 19 upgrade, WebSocket security & critical vulnerability fixes

</details>

Key Features of DeepTutor

📚 Massive Document Knowledge Q&A

• Smart Knowledge Base: Upload textbooks, research papers, technical manuals, and domain-specific documents. Build a comprehensive AI-powered knowledge repository for instant access.<br> • Multi-Agent Problem Solving: Dual-loop reasoning architecture with RAG, web search, and code execution -- delivering step-by-step solutions with precise citations.

🎨 Interactive Learning Visualization

• Knowledge Simplification & Explanations: Transform complex concepts, knowledge, and algorithms into easy-to-understand visual aids, detailed step-by-step breakdowns, and engaging interactive demonstrations.<br> • Personalized Q&A: Context-aware conversations that adapt to your learning progress, with interactive pages and session-based knowledge tracking.

🎯 Knowledge Reinforcement with Practice Exercise Generator

• Intelligent Exercise Creation: Generate targeted quizzes, practice problems, and customized assessments tailored to your current knowledge level and specific learning objectives.<br> • Authentic Exam Simulation: Upload reference exams to generate practice questions that perfectly match the original style, format, and difficulty—giving you realistic preparation for the actual test.

🔍 Deep Research & Idea Generation

• Comprehensive Research & Literature Review: Conduct in-depth topic exploration with systematic analysis. Identify patterns, connect related concepts across disciplines, and synthesize existing research findings.<br> • Novel Insight Discovery: Generate structured learning materials and uncover knowledge gaps. Identify promising new research directions through intelligent cross-domain knowledge synthesis.

<div align="center"> <img src="assets/figs/title_gradient.svg" alt="All-in-One Tutoring System" width="70%"> </div>  <table> <tr> <td width="50%" align="center" valign="top"> <h3>📚 Massive Document Knowledge Q&A</h3> <a href="#problem-solving-agent"> <img src="assets/gifs/solve.gif" width="100%"> </a> <br> <sub>Multi-agent Problem Solving with Exact Citations</sub> </td> <td width="50%" align="center" valign="top"> <h3>🎨 Interactive Learning Visualization</h3> <a href="#guided-learning"> <img src="assets/gifs/guided-learning.gif" width="100%"> </a> <br> <sub>Step-by-step Visual Explanations with Personal QAs.</sub> </td> </tr> </table>  <h3 align="center">🎯 Knowledge Reinforcement</h3> <table> <tr> <td width="50%" valign="top" align="center"> <a href="#question-generator"> <img src="assets/gifs/question-1.gif" width="100%"> </a>

Custom Questions
<sub>Auto-Validated Practice Questions Generation</sub>

</td> <td width="50%" valign="top" align="center"> <a href="#question-generator"> <img src="assets/gifs/question-2.gif" width="100%"> </a>

Mimic Questions
<sub>Clone Exam Style for Authentic Practice</sub>

</td> </tr> </table>  <h3 align="center">🔍 Deep Research & Idea Generation</h3> <table> <tr> <td width="33%" align="center"> <a href="#deep-research"> <img src="assets/gifs/deepresearch.gif" width="100%"> </a>

Deep Research
<sub>Knowledge Extension from Textbook with RAG, Web and Paper-search</sub>

</td> <td width="33%" align="center"> <a href="#idea-generation"> <img src="assets/gifs/ideagen.gif" width="100%"> </a>

Automated IdeaGen
<sub>Brainstorming and Concept Synthesis with Dual-filter Workflow</sub>

</td> <td width="33%" align="center"> <a href="#co-writer"> <img src="assets/gifs/co-writer.gif" width="100%"> </a>

Interactive IdeaGen
<sub>RAG and Web-search Powered Co-writer with Podcast Generation</sub>

</td> </tr> </table>  <h3 align="center">🏗️ All-in-One Knowledge System</h3> <table> <tr> <td width="50%" align="center"> <a href="#dashboard--knowledge-base-management"> <img src="assets/gifs/knowledge_bases.png" width="100%"> </a>

Personal Knowledge Base
<sub>Build and Organize Your Own Knowledge Repository</sub>

</td> <td width="50%" align="center"> <a href="#notebook"> <img src="assets/gifs/notebooks.png" width="100%"> </a>

Personal Notebook
<sub>Your Contextual Memory for Learning Sessions</sub>

</td> </tr> </table> <p align="center"> <sub>🌙 Use DeepTutor in <b>Dark Mode</b>!</sub> </p>

🏛️ DeepTutor's Framework

💬 User Interface Layer

• Intuitive Interaction: Simple bidirectional query-response flow for intuitive interaction.<br> • Structured Output: Structured response generation that organizes complex information into actionable outputs.

🤖 Intelligent Agent Modules

• Problem Solving & Assessment: Step-by-step problem solving and custom assessment generation.<br> • Research & Learning: Deep Research for topic exploration and Guided Learning with visualization.<br> • Idea Generation: Automated and interactive concept development with multi-source insights.

🔧 Tool Integration Layer

• Information Retrieval: RAG hybrid retrieval, real-time web search, and academic paper databases.<br> • Processing & Analysis: Python code execution, query item lookup, and PDF parsing for document analysis.

🧠 Knowledge & Memory Foundation

• Knowledge Graph: Entity-relation mapping for semantic connections and knowledge discovery.<br> • Vector Store: Embedding-based semantic search for intelligent content retrieval.<br> • Memory System: Session state management

DeepTutor

Install / Use

README