🚀 DeepTutor v0.3.0 Release Notes

Release Date: January 6, 2026

We're excited to announce DeepTutor v0.3.0! This release focuses on developer experience improvements, CI/CD automation, and simplified local deployment.

✨ Highlights

🏗️ Unified PromptManager Architecture

A major refactor consolidates all prompt loading across 10+ agent modules into a centralized PromptManager singleton:

• Global caching with module-level invalidation for improved performance
• Language fallback chain (zh → en, en → zh) for seamless i18n support
• ISO 639-1 compliance — all cn/ prompt directories renamed to zh/
• Simplified agent code by removing redundant _load_prompts methods and class-level caches

🤖 GitHub Actions & CI/CD

Introducing automated workflows for better code quality and easier deployment:

🐳 Pre-built Docker Images

Deploy in ~30 seconds using our pre-built image from GitHub Container Registry:

docker run -d --name deeptutor
-p 8001:8001 -p 3782:3782
--env-file .env
-v $(pwd)/data:/app/data
ghcr.io/hkuds/deeptutor:latest### 🏠 Local-First LLM Configuration

Simplified settings page now focuses exclusively on local LLM providers:

• ✅ Ollama (default)
• ✅ LM Studio
• ❌ Removed cloud providers (OpenAI, Gemini, Azure, etc.)

This aligns with DeepTutor's vision for privacy-first, self-hosted AI tutoring.

📦 What's Changed

Core Infrastructure

• Added src/core/prompt_manager.py with singleton PromptManager
• Export get_prompt_manager() from src/core/__init__.py
• Added /api/v1/config/agents endpoint for data-driven frontend configuration

Agent Modules Migrated (10 files)

• research/agents/base_agent.py
• solve/base_agent.py
• guide/agents/base_guide_agent.py
• question/agents/generation_agent.py
• question/agents/validation_agent.py
• question/validation_workflow.py
• ideagen/idea_generation_workflow.py
• ideagen/material_organizer_agent.py
• co_writer/edit_agent.py
• co_writer/narrator_agent.py

Removed Legacy Code

• Deleted src/agents/solve/utils/prompt_loader.py
• Removed use_prompt_loader parameter from BaseAgent
• Cleaned up _PROMPT_CACHE class-level caches across all modules
• Removed PromptLoader exports from solve/__init__.py

⬆️Upgrade

git pull origin main
docker pull ghcr.io/hkuds/deeptutor:latestCloses #33

What's Changed

• fix(UI): unrendered markdown in ActivityDetail card by @tusharkhatriofficial in #26
• chore: transtale readme to ru by @oshliaer in #27
• fix: improve reload_excludes configuration for uvicorn server and added support for newer models (openai) by @LouisACR in #28
• feat: Dynamic LLM Provider Support (Local & Cloud) by @ahmedjawedaj in #34

🤝New Contributors

• @oshliaer made their first contribution in #27
• @LouisACR made their first contribution in #28
• @ahmedjawedaj made their first contribution in #34