Just User.
← Все гайды

УРОК

DeepTutor — УРОК

УРОК — DeepTutor: установка и первое занятие на Windows

DeepTutor помогает разбирать учебные материалы с ИИ. Начни с небольшого текста и одной темы: так проще проверить настройку и понять, подходит ли тебе такой формат занятий.

Оригинальный репозиторий и инструкция

Открыть материал ↗github.com/HKUDS/DeepTutor

1. Подготовь компьютер

Нужны Python 3.11–3.14 и Node.js. Для этого гайда используй Node.js 22: он подходит под требование проекта Node.js 20+ для готового приложения.

Скачать Python

Открыть материал ↗www.python.org/downloads/

Скачать Node.js

Открыть материал ↗nodejs.org/

При установке Python включи Add Python to PATH. После установки открой новое окно PowerShell и проверь:

Текст для копирования
py --version
node --version

Версия Python должна входить в диапазон выше. Если установлен другой Python, выбери подходящую версию до создания окружения.

2. Установи полное приложение

В PowerShell выполни по очереди:

Текст для копирования
mkdir my-deeptutor
cd my-deeptutor
py -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -U "deeptutor[full]"

Дождись завершения каждой команды. Здесь используется отдельное окружение, а полный путь к python.exe позволяет обойтись без активации PowerShell-скриптом.

Если папка my-deeptutor уже существует, не создавай её повторно: сначала проверь, что в ней находится. Не смешивай этот вариант с обновлением старой установки.

Важно сохранить [full]: начиная с версии 1.7.0 обычный пакет deeptutor устанавливает только ядро, без полного веб-приложения.

3. Подключи модель

В той же папке запусти:

Текст для копирования
.\.venv\Scripts\deeptutor.exe init

Выбери провайдера, модель и укажи её API-ключ. Для поиска по базе документов настрой также модель эмбеддингов — она превращает фрагменты текста в представление для поиска. Веб-поиск настраивается отдельно и для первого урока не обязателен.

Предлагаемые порты можно оставить: 8001 для сервера и 3782 для интерфейса. Сам проект бесплатный; платные API оплачиваются отдельно. Не вставляй ключ в учебные запросы и не публикуй его на скриншотах.

4. Открой DeepTutor

Запусти:

Текст для копирования
.\.venv\Scripts\deeptutor.exe start

Открой адрес из терминала. По умолчанию: http://127.0.0.1:3782

Оставь терминал открытым. Чтобы завершить работу, нажми Ctrl+C. В следующий раз открой PowerShell, перейди в свою папку my-deeptutor и снова выполни команду start — повторная установка не нужна.

5. Проведи первый урок

Добавь небольшой учебный материал. Если создаёшь базу знаний, дождись завершения обработки и индексации. Затем отправь:

Текст для копирования
Объясни тему из этого материала простыми словами. Сначала выясни мой уровень, затем разбери один пример по шагам и дай похожее задание. Не показывай ответ, пока я не попробую решить сам. Отвечай по-русски. Отделяй сведения из материала от собственных пояснений и указывай, где проверить важные утверждения.

После своего ответа попроси не готовое решение, а подсказку к конкретному шагу. В конце занятия попроси три коротких вопроса для самопроверки.

6. Если что-то не работает

  • Команда py не найдена: проверь установку Python и открой новый PowerShell.
  • Не запускается интерфейс: проверь node --version и сообщения в терминале.
  • Приложение открывается, но не отвечает: проверь модель, ключ и доступный лимит API.
  • Поиск по документу не работает: проверь модель эмбеддингов и завершение индексации.
  • Адрес не открывается: используй именно URL, напечатанный текущим запуском, особенно если менял порты.

Не запускай команды установки снова наугад. Сохрани полный текст ошибки, скрыв ключи и личные данные. Ответы ИИ сверяй с учебником или исходным материалом; личные документы загружай с учётом того, как выбранный провайдер обрабатывает данные.

Все материалы из роликов

Открыть материал ↗t.me/justuserai