# DeepTutor

DeepTutor is an open-source, agent-native learning workspace that unifies AI-powered tutoring, research, content creation, and practice in a single extensible system.

Canonical page: https://ourlocalhost.com/app/7533/deeptutor

## Description

DeepTutor is an open-source, agent-native learning workspace that unifies AI-powered tutoring, research, content creation, and practice in a single extensible system. It runs locally as a browser application or terminal CLI, letting self-directed learners and educators build personalized tutoring workflows with their own AI model providers.

## Platform availability

Available on 3 of 10 platforms: Mac, Windows, Any server.

## Desktop and other devices

Mac, Windows.

## Health score

86/100 (Excellent), based on 3 of 4 factors.
- Maintained: 100 (last commit 15 days ago)
- Popular: 95 (57,144 GitHub stars)
- Easy to install: 45 (3 install platforms, install notes)

## Links

- GitHub: https://github.com/HKUDS/DeepTutor
- desktop: https://github.com/HKUDS/DeepTutor/releases/latest
- Official website: http://arxiv.org/abs/2604.26962

## Common questions

### Which DeepTutor installation do I need for the browser app and the CLI?

Use python -m pip install -U deeptutor[full] for the web app and CLI, with Python 3.11 to 3.14 and Node.js 20.9 or newer. Use plain deeptutor only for a terminal-only setup.

### What startup command should I run and where do I open the app?

Run deeptutor init to choose your AI provider and local web settings, then run deeptutor start and open the printed address, usually port 3782. Skipping init can leave DeepTutor unable to choose an AI service.

### How can I check that my AI provider is actually working?

deeptutor init only saves settings, so run deeptutor doctor --online for a small live test that may use a tiny amount of AI service credit. Without a valid API key, DeepTutor may open but questions may not get proper AI answers.

### Can I run DeepTutor with a local Ollama model instead of a cloud API?

Yes, DeepTutor can be set up with Ollama for a private, self-hosted AI tutor. It can run quiz, solve, research, and visualize modes without cloud services.

### What are common causes when embeddings or document uploads fail?

Failures can be caused by an embedding provider returning 429, an unreachable embedding host, or a PDF parser failing on a password-protected file. For rate limits, retry with smaller batches.

---
Source: Our Local Host (https://ourlocalhost.com/app/7533/deeptutor), the self-hosted and open-source app directory.
