УРОК — DeepTutor: установка и первое занятие на Windows
DeepTutor помогает разбирать учебные материалы с ИИ. Начни с небольшого текста и одной темы: так проще проверить настройку и понять, подходит ли тебе такой формат занятий.
Оригинальный репозиторий и инструкция
Открыть материал ↗github.com/HKUDS/DeepTutor1. Подготовь компьютер
Нужны 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, напечатанный текущим запуском, особенно если менял порты.
Не запускай команды установки снова наугад. Сохрани полный текст ошибки, скрыв ключи и личные данные. Ответы ИИ сверяй с учебником или исходным материалом; личные документы загружай с учётом того, как выбранный провайдер обрабатывает данные.