Skip to content

README_RU.md

Latest commit

 

History

History
422 lines (299 loc) · 15.6 KB

README_RU.md

File metadata and controls

422 lines (299 loc) · 15.6 KB

📰 Новости

[2026.3.24] DeepTutor v1.0.0 ✨ — агентно-нативная эволюция: лёгкий рефакторинг, TutorBot, гибкие режимы под Apache-2.0.

[2026.2.6] 🚀 10k звёзд за 39 дней — спасибо сообществу!

[2026.1.1] С Новым годом! Discord, WeChat, Discussions.

[2025.12.29] Официальный релиз DeepTutor.

📦 Релизы

[2026.3.24] v1.0.0 — агентно-нативный рефакторинг, гибкие инструменты, CLI и SDK, TutorBot на nanobot, Co-Writer, Guided Learning, постоянная память.

Прошлые релизы

[2026.1.23] v0.6.0 — сессии, инкрементальная загрузка, гибкий RAG, полная китайская локализация.

[2026.1.18] v0.5.2 — Docling, логи, исправления.

[2026.1.15] v0.5.0 — единая конфигурация, RAG по KB, генерация вопросов, боковая панель.

[2026.1.9] v0.4.0 — мульти-провайдеры LLM/эмбеддинги, новая главная, разделение RAG, переменные окружения.

[2026.1.5] v0.3.0 — PromptManager, CI/CD, образы GHCR.

[2026.1.2] v0.2.0 — Docker, Next.js 16 и React 19, WebSocket, уязвимости.

✨ Ключевые возможности

  • Единое чат-пространство — пять режимов в одной ветке: Chat, Deep Solve, квизы, Deep Research, Math Animator с общим контекстом.
  • Персональные TutorBot — не чат-боты: автономные репетиторы со своей памятью, личностью и навыками. nanobot.
  • AI Co-Writer — Markdown: переписать, расширить, сократить с KB и вебом.
  • Guided Learning — визуальные пошаговые маршруты по вашим материалам.
  • Центр знаний — PDF, Markdown, текст для RAG; цветные блокноты.
  • Постоянная память — сводка прогресса и профиль ученика; общая с TutorBot.
  • Агентно-нативный CLI — возможности, KB, сессии, TutorBot одной командой; Rich и JSON. SKILL.md.

🚀 Быстрый старт

Вариант A — интерактивный тур (рекомендуется)

Один скрипт — зависимости, окружение, проверка связи, запуск.

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor

conda create -n deeptutor python=3.11 && conda activate deeptutor
# или: python -m venv .venv && source .venv/bin/activate

python scripts/start_tour.py
  • Web — профиль, pip + npm, временный сервер, Настройки, 4 шага (LLM, эмбеддинги, поиск).
  • CLI — всё в терминале.

http://localhost:3782

Вариант B — ручная локальная установка

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor

conda create -n deeptutor python=3.11 && conda activate deeptutor
pip install -e ".[server]"

cd web && npm install && cd ..
cp .env.example .env
LLM_BINDING=openai
LLM_MODEL=gpt-4o-mini
LLM_API_KEY=sk-xxx
LLM_HOST=https://api.openai.com/v1

EMBEDDING_BINDING=openai
EMBEDDING_MODEL=text-embedding-3-large
EMBEDDING_API_KEY=sk-xxx
EMBEDDING_HOST=https://api.openai.com/v1
EMBEDDING_DIMENSION=3072
python -m deeptutor.api.run_server
cd web && npm run dev -- -p 3782
Сервис Порт
Backend 8001
Frontend 3782

Вариант C — Docker

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor
cp .env.example .env

Как в варианте B.

2a. Официальный образ — GHCR

docker compose -f docker-compose.ghcr.yml up -d

2b. Сборка — docker compose up -d

3. http://localhost:3782

docker compose logs -f
docker compose down
Облако / удалённый сервер 
NEXT_PUBLIC_API_BASE_EXTERNAL=https://your-server.com:8001
Режим разработки (hot-reload) 
docker compose -f docker-compose.yml -f docker-compose.dev.yml up
Свои порты 
BACKEND_PORT=9001
FRONTEND_PORT=4000
Персистентность данных
Контейнер Хост Содержимое
/app/data/user ./data/user Настройки, память, workspace, сессии, логи
/app/data/knowledge_bases ./data/knowledge_bases Документы и векторы
Переменные окружения
Переменная Обяз. Описание
LLM_BINDING Да Провайдер LLM
LLM_MODEL Да Модель
LLM_API_KEY Да Ключ
LLM_HOST Да URL
EMBEDDING_BINDING Да Эмбеддинги
EMBEDDING_MODEL Да Модель
EMBEDDING_API_KEY Да Ключ
EMBEDDING_HOST Да URL
EMBEDDING_DIMENSION Да Размерность
SEARCH_PROVIDER Нет Поиск
SEARCH_API_KEY Нет Ключ
BACKEND_PORT Нет по умолч. 8001
FRONTEND_PORT Нет по умолч. 3782
NEXT_PUBLIC_API_BASE_EXTERNAL Нет Публичный URL
DISABLE_SSL_VERIFY Нет по умолч. false

Вариант D — только CLI

pip install -e ".[cli]"
deeptutor chat
deeptutor run chat "Explain Fourier transform"
deeptutor run deep_solve "Solve x^2 = 4"
deeptutor kb create my-kb --doc textbook.pdf

Полное руководство: DeepTutor CLI.

📖 Обзор DeepTutor

Архитектура DeepTutor

💬 Чат — единое интеллектуальное пространство

Чат

Пять режимов, единый контекст.

Режим Назначение
Chat RAG, веб, код, рассуждения, мозговой штурм, статьи.
Deep Solve Мультиагенты с цитатами.
Генерация квизов Оценки по KB.
Deep Research Подтемы, параллельные агенты, отчёт с ссылками.
Math Animator Manim.

Инструменты отделены от сценариев.

✍️ Co-Writer — ИИ в редакторе

Co-Writer

Переписать, Расширить, Сократить; отмена/повтор; блокноты.

🎓 Guided Learning

Guided Learning
  1. План (3–5 пунктов).
  2. Интерактивные страницы.
  3. Контекстные вопросы.
  4. Итог.

📚 Управление знаниями

Знания
  • Базы знаний — PDF, TXT, MD.
  • Блокноты — по сессиям и цветам.

🧠 Память

Память
  • Сводка — прогресс.
  • Профиль — предпочтения, уровень, цели. Общая с TutorBot.

🦞 TutorBot — постоянные автономные ИИ-репетиторы

Архитектура TutorBot

Мультиинстансный агент на nanobot: свой цикл, workspace, память, личность.

TutorBot
  • Шаблоны Soul — личность и педагогика.
  • Отдельный workspace — память, сессии, навыки; общий слой DeepTutor.
  • Проактивный Heartbeat — напоминания и задачи.
  • Полный набор инструментов — RAG, код, веб, статьи, рассуждения, мозговой штурм.
  • Навыки — файлы skill.
  • Мультиканал — Telegram, Discord, Slack, Feishu, WeCom, DingTalk, почта и др.
  • Команды и субагенты.
deeptutor bot create math-tutor --persona "Socratic math teacher who uses probing questions"
deeptutor bot create writing-coach --persona "Patient, detail-oriented writing mentor"
deeptutor bot list

⌨️ DeepTutor CLI — интерфейс для агентов

CLI

Без браузера: возможности, KB, сессии, память, TutorBot. Rich + JSON. SKILL.md.

deeptutor run chat "Explain the Fourier transform" -t rag --kb textbook
deeptutor run deep_solve "Prove that √2 is irrational" -t reason
deeptutor run deep_question "Linear algebra" --config num_questions=5
deeptutor run deep_research "Attention mechanisms in transformers"
deeptutor chat --capability deep_solve --kb my-kb
deeptutor kb create my-kb --doc textbook.pdf
deeptutor kb add my-kb --docs-dir ./papers/
deeptutor kb search my-kb "gradient descent"
deeptutor kb set-default my-kb
deeptutor run chat "Summarize chapter 3" -f rich
deeptutor run chat "Summarize chapter 3" -f json
deeptutor session list
deeptutor session open <id>
Полная справка CLI
Команда Описание
deeptutor run <capability> <message> Один проход
deeptutor chat REPL
deeptutor serve API-сервер

bot, kb, memory, session, notebook, config / plugin / provider — как в английском README.

🌐 Сообщество и экосистема

Проект Роль
nanobot Движок TutorBot
LlamaIndex RAG
ManimCat Math Animator
⚡ LightRAG 🤖 AutoAgent 🔬 AI-Researcher 🧬 nanobot
Быстрый RAG Агенты без кода Автоисследования Лёгкий агент

🤝 Участие

См. CONTRIBUTING.md.

⭐ История звёзд