# DeepTutor CLI

Configures and runs DeepTutor from the command line, including knowledge bases and sessions.

- Repository: https://github.com/HKUDS/DeepTutor (53613 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add HKUDS/DeepTutor --skill deeptutor-cli -g -a claude-code -y`
Codex: `npx skills add HKUDS/DeepTutor --skill deeptutor-cli -g -a codex -y`
Cursor: `npx skills add HKUDS/DeepTutor --skill deeptutor-cli -g -a cursor -y`
Gemini CLI: `npx skills add HKUDS/DeepTutor --skill deeptutor-cli -g -a gemini-cli -y`

## Description

Configure, manage, and use DeepTutor through its CLI, including capabilities, knowledge bases, partners, memory, sessions, notebooks, providers, skills, and the server or Web app.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# DeepTutor CLI Skill

> Teach your AI agent to configure, manage, and use DeepTutor, an intelligent learning platform, entirely through the command line.

## When to Use

Use this skill when the user wants to:
- Set up or configure DeepTutor
- Diagnose problems in an existing DeepTutor installation
- Chat with DeepTutor or run a capability (deep solve, quiz generation, deep research, visualize, math animation, mastery path)
- Create, manage, or search knowledge bases
- Create, manage, or run Partners (IM-connected companions)
- Search, install, or manage skills from a hub (EduHub or ClawHub)
- Inspect or maintain interactive Books
- View or manage learning memory, sessions, or notebooks
- Start the DeepTutor API server or the full Web app

## Prerequisites

- Python 3.11, 3.14
- For the 1.7.0 modular release, `pip install "deeptutor[full]"` installs the packaged Web app; bare `deeptutor` (or the `deeptutor-cli` compatibility alias) installs core CLI/SDK only. For development, use source or local wheels. Source installs require `pip install -r requirements/full.txt` followed by `pip install -e . --no-deps`; add Node.js 22 LTS and `npm ci --legacy-peer-deps` in `web/` for the Web UI. See the setup guide for upgrading from 1.6.15 without changing the runtime home.
- Run `deeptutor init` for first-time interactive setup. It walks a guided wizard (ports → LLM → embedding → search → review) and writes the same settings as the Web Settings page under `data/user/settings`. Add `--cli` to skip the ports step for CLI-only use, or `--home <path>` to target a specific workspace.

## Agent Setup

The rest: https://github.com/HKUDS/DeepTutor/blob/HEAD//SKILL.md