# DeepTutor | ✨Data Intelligence Lab@HKU✨ | Knowledge Base | Instagit

"DeepTutor: Agent-Native Personalized Learning Assistant"

GitHub Stars: 12.9k

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

---

## Articles

### [Where Are the Utility Functions in DeepTutor Defined?](/HKUDS/DeepTutor/where-are-the-utility-functions-in-deep-tutor-defined)

Discover where DeepTutor utility functions are defined. Find centralized code in deeptutor/utils for JSON parsing, network resilience, error handling, validation, and configuration.

- Tags: internals
- Published: 2026-04-08

### [DeepTutor Best Practices: Optimizing the Two‑Layer Plugin Architecture](/HKUDS/DeepTutor/what-are-the-best-practices-for-using-deep-tutor)

Implement DeepTutor best practices for its two layer plugin architecture. Minimize tool sets, persist session IDs, and handle async events for efficient production deployments.

- Tags: best-practices
- Published: 2026-04-08

### [How to Customize DeepTutor's Behavior: Complete Configuration Guide](/HKUDS/DeepTutor/how-to-customize-deep-tutor-s-behavior)

Customize DeepTutor's behavior using its dual-layer registry architecture. Modify tools, capabilities, and agent parameters via YAML files, environment variables, and plugins without touching source code.

- Tags: how-to-guide
- Published: 2026-04-08

### [How to Deploy DeepTutor to Production: Complete Docker Setup Guide](/HKUDS/DeepTutor/how-to-deploy-deep-tutor-to-production)

Deploy DeepTutor to production with this complete Docker setup guide. Learn to configure environment variables, build the Docker image, and launch the FastAPI backend and Next.js frontend using docker compose.

- Tags: how-to-guide
- Published: 2026-04-08

### [DeepTutor System Architecture: An Agent-Native Platform with Two-Layer Registry](/HKUDS/DeepTutor/what-is-the-architecture-of-the-deep-tutor-system)

Explore the DeepTutor system architecture, an agent-native platform with a two-layer registry. Discover its modular design for efficient task execution and request routing.

- Tags: architecture
- Published: 2026-04-08

### [How to Debug Issues in DeepTutor: A Complete Troubleshooting Guide](/HKUDS/DeepTutor/how-to-debug-issues-in-deep-tutor)

Debug DeepTutor issues effectively. Enable verbose logging, inspect UnifiedContext, and monitor StreamBus events to trace execution flow from input to output.

- Tags: how-to-guide
- Published: 2026-04-08

### [How the Machine Learning Model Is Implemented in DeepTutor: A Pluggable LLM Architecture](/HKUDS/DeepTutor/how-is-the-machine-learning-model-implemented-in-deep-tutor)

Discover how DeepTutor implements its machine learning model using a pluggable LLM architecture. Explore its unified access to large language models via consistent interfaces.

- Tags: internals
- Published: 2026-04-08

### [Requirements for Running DeepTutor: Complete Setup Guide](/HKUDS/DeepTutor/what-are-the-requirements-for-running-deep-tutor)

Discover the requirements for running DeepTutor. Learn about Python 3.11+, Node.js, and environment variable setup for LLM providers. Get your complete setup guide now.

- Tags: getting-started
- Published: 2026-04-08

### [How to Integrate DeepTutor with Other Systems: CLI, API, and Python SDK Patterns](/HKUDS/DeepTutor/how-to-integrate-deep-tutor-with-other-systems)

Learn how to integrate DeepTutor with other systems using CLI, HTTP API, or Python SDK. Explore patterns for automation scripts, web services, and embedded applications for consistent behavior.

- Tags: how-to-guide
- Published: 2026-04-08

### [Where Is the Documentation for DeepTutor? A Complete Guide to Setup Guides and API References](/HKUDS/DeepTutor/where-is-the-documentation-for-deep-tutor)

Find DeepTutor documentation easily. Access setup guides API references and more directly within the HKUDS DeepTutor GitHub repository.

- Tags: api-reference
- Published: 2026-04-08

### [DeepTutor Configuration Files: A Complete Guide to Setup and Customization](/HKUDS/DeepTutor/what-are-the-configuration-files-for-deep-tutor)

Master DeepTutor configuration files YAML and ENV. Learn setup and customization for API keys, server ports, LLM settings, and UI preferences. Optimize your DeepTutor experience.

- Tags: how-to-guide
- Published: 2026-04-08

### [How to Train a DeepTutor Model: A Complete Configuration Guide](/HKUDS/DeepTutor/how-to-train-a-deep-tutor-model)

Learn how to train a DeepTutor model by fine-tuning an external LLM. This guide details the configuration steps to integrate custom models into the agent-native orchestration layer.

- Tags: how-to-guide
- Published: 2026-04-08

### [Where Are the Data Processing Scripts in DeepTutor? Complete Guide to the scripts/ Directory](/HKUDS/DeepTutor/where-are-the-data-processing-scripts-in-deep-tutor-located)

Find DeepTutor data processing scripts within the scripts/ directory. This guide details Python utilities for KB migration, user data transfer, embedding generation, and web UI setup.

- Tags: how-to-guide
- Published: 2026-04-08

### [How to Install DeepTutor Locally: 4 Methods from Guided Setup to Docker](/HKUDS/DeepTutor/how-to-install-deep-tutor-locally)

Learn how to install DeepTutor locally with 4 easy methods including guided setup and Docker. Get started with HKUDS/DeepTutor today.

- Tags: how-to-guide
- Published: 2026-04-08

### [What Are the Dependencies for DeepTutor? Complete Package Stack Guide](/HKUDS/DeepTutor/what-are-the-dependencies-for-deep-tutor)

Explore the DeepTutor dependencies organized into four hierarchical layers Core CLI Server TutorBot and Development Learn about the complete package stack guide for this project.

- Tags: getting-started
- Published: 2026-04-08

### [How to Contribute to the DeepTutor Project: A Developer's Guide to Agent-Native Architecture](/HKUDS/DeepTutor/how-to-contribute-to-the-deep-tutor-project)

Contribute to DeepTutor by extending its agent-native architecture with new Tools or Capabilities. Submit pull requests to the dev branch after pre-commit checks.

- Tags: how-to-guide
- Published: 2026-04-08

### [Programming Languages Used in DeepTutor: Python Backend and TypeScript Frontend Architecture](/HKUDS/DeepTutor/what-programming-languages-are-used-in-deep-tutor)

Discover the programming languages powering DeepTutor. Explore its Python backend for AI and TypeScript frontend for seamless user experiences.

- Tags: deep-dive
- Published: 2026-04-08

### [DeepTutor Project Structure: A Modular Agent-Native Architecture Guide](/HKUDS/DeepTutor/how-is-the-deep-tutor-project-structured)

Explore the DeepTutor project structure. Discover its modular agent-native architecture, layered design, and two-level registry system for tools and capabilities.

- Tags: architecture
- Published: 2026-04-08

### [How to Find and Run the Main Script for DeepTutor](/HKUDS/DeepTutor/where-to-find-the-main-script-to-run-deep-tutor)

Discover how to find and run the main script for DeepTutor. Learn to launch the CLI or web interface by locating key Python files in the DeepTutor repository.

- Tags: how-to-guide
- Published: 2026-04-08

### [Core Components of the DeepTutor Codebase: Architecture and Runtime Flow](/HKUDS/DeepTutor/what-are-the-core-components-of-deep-tutor-codebase)

Explore the core components of the DeepTutor codebase: orchestration, context management, streaming, L2 agents, L1 tools, and registries. Understand its layered architecture and runtime flow.

- Tags: architecture
- Published: 2026-04-08