HubLensLLMHKUDS/DeepTutor
// archived 2026-04-27
95

// summary

DeepTutor is an agent-native platform designed to provide personalized, intelligent tutoring through a unified chat workspace and multi-agent architecture. It features advanced capabilities like a Book Engine for interactive learning, an AI Co-Writer, and persistent memory to tailor the experience to individual user profiles. Users can deploy the system easily via a guided CLI setup or Docker, supporting a wide range of LLM and embedding providers.

// technical analysis

DeepTutor is an agent-native, personalized tutoring platform designed to transform static learning materials into interactive, autonomous educational experiences. By utilizing a unified architecture that integrates chat, research, visualization, and document management, the project solves the fragmentation common in AI-assisted learning tools. Its design philosophy centers on persistent memory and multi-agent collaboration, allowing users to build a living profile that evolves with their educational journey. The project makes significant technical trade-offs by prioritizing a plugin-based capability model and schema-driven agents, which enables high extensibility while maintaining a cohesive user experience across diverse LLM providers.

// key highlights

01
Unified Chat Workspace allows seamless transitions between six distinct learning modes, including Deep Solve, Quiz Generation, and Math Animator, within a single persistent thread.
02
The Book Engine transforms static documents into interactive 'living books' featuring 14 different block types like concept graphs, flashcards, and timelines.
03
AI Co-Writer provides a collaborative Markdown workspace that allows users to rewrite, expand, or summarize content while drawing directly from their personal knowledge base.
04
Personal TutorBots function as autonomous agents with unique personalities, memories, and skill sets that evolve alongside the user's learning progress.
05
The Agent-Native CLI offers a powerful interface for both humans and machines, supporting structured JSON output for autonomous pipeline operations.
06
Persistent Memory builds a comprehensive user profile that tracks learning history and preferences, ensuring that every interaction improves the quality of future tutoring.

// use cases

01
Unified chat workspace for multi-agent problem solving, research, and visualization
02
Book Engine for transforming educational materials into interactive living books
03
Autonomous TutorBots with persistent memory and customizable skill sets

// getting started

To begin, clone the repository and use the 'Setup Tour' by running 'python scripts/start_tour.py' within a Python 3.11+ virtual environment to automatically handle dependencies and configuration. Once the guided tour completes, you can launch the application using 'python scripts/start_web.py'. Alternatively, users can opt for a manual installation by configuring the .env file with LLM and embedding API keys or deploy via Docker using the provided compose files.