HKUDS/DeepTutor

DeepTutor: персонализированный репетитор на базе агентов. https://deeptutor.info/.

Агенты⭐ 40 090Pythonпоследний релиз: v1.6.9
Открыть на GitHub ↗Сайт проекта ↗

Что это за инструмент

DeepTutor — это open-source платформа для персонализированного обучения на базе AI-агентов, позволяющая создавать интерактивных репетиторов и управлять учебными материалами.

Зачем нужен

Инструмент решает задачу автоматизации образовательного процесса, предоставляя систему для создания, настройки и взаимодействия с AI-тьюторами. Он полезен для внедрения адаптивного обучения, где материалы и ответы адаптируются под конкретного пользователя, а также для управления большими базами знаний с помощью RAG.

Что можно реализовать

  • Создание персонализированных AI-репетиторов, которые ведут диалог с учеником и отвечают на вопросы.
  • Генерация и проверка тестов (включая варианты с множественным выбором) с использованием LaTeX и автоматической оценкой.
  • Построение систем обучения на основе собственных документов (Knowledge Base) с использованием LightRAG и FAISS для быстрого поиска.
  • Администрирование образовательной платформы: управление пользователями, профилями и назначением AI-партнеров (агентов) конкретным ученикам.

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

  • Agent-native архитектура: поддержка взаимодействия с различными AI-партнерами через чат и инструменты MCP.
  • Гибкая работа с данными: интеграция LightRAG Server, PyMuPDF4LLM для парсинга PDF и FAISS для векторного поиска.
  • Поддержка сложных форматов: рендеринг LaTeX в вопросах и тестах, работа с не-латинскими именами и путями.
  • Удобный интерфейс и CLI: Next.js фронтенд, командная строка для управления, изоляция сессий пользователей.
  • Активная экосистема: поддержка Docker/Podman, наличие документации на многих языках и активное сообщество.

👤 Кому подойдёт: разработчики, исследователи в области EdTech, преподаватели и технические специалисты, внедряющие AI-решения в образование

Релизы

v1.6.9majorbreaking
🕐 20 ч назад · релиз на GitHub ↗

DeepTutor v1.6.9: рабочие пространства, ежедневная практика, переработанные настройки и архивация чатов.

  • Added: Появились рабочие пространства (Workspaces) для изоляции данных обучения и генерируемых файлов.
  • Added: Добавлен режим ежедневной практики с отслеживанием ошибок и статистикой по существующей базе вопросов.
  • Breaking: Удаление чата теперь означает безвозвратное удаление; для сохранения данных используется архивация.
  • Added: Настройки разделены на отдельные страницы с группировкой по категориям и улучшенным управлением провайдерами.
  • Added: Улучшен интерфейс потокового вывода: инструменты выполнения отображаются в контексте диалога.
  • Added: Добавлена поддержка синтеза и транскрипции через Doubao Speech от Volcengine.
v1.6.8minorbreaking
🕐 7 дн назад · релиз на GitHub ↗

Восстановление удалённых чатов, поиск по истории, новый инструмент knowledge_frontier и исправления стабильности.

  • Added: Удалённые чаты перемещаются в корзину, откуда их можно восстановить вместе с вложениями и состоянием.
  • Added: Добавлен поиск по тексту всех сообщений в истории, а не только по заголовкам.
  • Added: Появился инструмент knowledge_frontier для поиска свежих работ, выходящих за рамки текущей базы знаний.
  • Fixed: Исправлена ошибка, из-за которой модели не удавалось сообщить о превышении лимита токенов на рассуждения.
  • Fixed: Устранены проблемы с открытием книг, отображением вложений и обработкой сканированных PDF-файлов.
  • Breaking: Все лимиты токенов для LLM теперь централизованно управляются через файл agents.yaml.
v1.6.7minor
🕐 10 дн назад · релиз на GitHub ↗

Исправлены критические сбои генерации книг и квизов из-за лимитов токенов, утечки черновиков мышления и ошибок инструментов.

  • Fixed: Устранена проблема генерации книг: увеличен лимит токенов, добавлена повторная попытка при исчерпании бюджета и исправлена ошибка пустых глав.
  • Fixed: Удалены скрытые черновики мышления (scratchpad) из ответов модели в нестриминговом режиме для книг.
  • Fixed: Исправлена работа моделей с мышлением (DeepSeek, Qwen, Kimi и др.): теперь история контекста корректно сохраняется между ходами.
  • Fixed: Квизы больше не генерируются пустыми: добавлена обработка ошибок и повторные попытки при нехватке токенов.
  • Fixed: Теперь отображаются реальные ошибки инструментов (например, RAG) и улучшен рендеринг математических формул в интерфейсе.
v1.6.6patch
🕐 13 дн назад · релиз на GitHub ↗

Исправления: отправка ответов, копирование, загрузка KB, OAuth в Docker и оптимизация первого запуска.

  • Fixed: Исправлена отправка ответов: исправлены ошибки в composer'ах и сохранение заметок с изображениями.
  • Fixed: Кнопка копирования теперь корректно проверяет доступ к буферу обмена до первого await.
  • Fixed: Исправлено создание и удаление баз знаний с некорректными именами и загрузка крупных файлов.
  • Added: Оптимизация первого запуска: уменьшен размер начального бандла за счет ленивой загрузки интерфейсов.
  • Fixed: Партнеры теперь могут использовать подключенные базы знаний, а не только папки.
  • Fixed: OAuth-вход в Docker теперь поддерживает ручной ввод URL-адреса при недоступности localhost.
v1.6.5majorbreaking
🕐 15 дн назад · релиз на GitHub ↗

DeepTutor v1.6.5: единая среда выполнения кода, изолированное рабочее пространство и улучшенная настройка.

  • Breaking: Инструмент code_execution удалён, его функции перенесены в exec с указанием языка.
  • Added: Появилась рабочая папка (workspace) для хранения материалов и изолированного вывода.
  • Added: Объединены инструменты выполнения кода в один exec с общим окружением.
  • Added: Settings теперь чётко разделяет ошибки конфигурации и отсутствие настроек.
  • Added: Mastery Path строго контролирует режимы обучения и редактирования плана.
v1.6.4minorbreaking
🕐 18 дн назад · релиз на GitHub ↗

DeepTutor v1.6.4: оптимизация запуска, изоляция задач, улучшенные Books, Mastery Path и управление моделями.

  • Added: Легкий запуск и изоляция тяжелых задач через воркеры для стабильности сервера.
  • Added: Books: прозрачный план генерации, выбор контента и отслеживание статуса задач.
  • Added: Mastery Path: фильтрация локальной базы знаний и контроль покрытия материала.
  • Added: Reading и чаты: сохранение позиций, навигация и экспорт заметок.
  • Added: Профили моделей: явное описание протоколов, поддерживаемых функций и авто-маршрутизация.
  • Breaking: Изменены пути хранения памяти и API-форматов; расширениям нужно обновить импорты.
v1.6.3majorbreaking
🕐 19 дн назад · релиз на GitHub ↗

DeepTutor v1.6.3: ломает API, добавляет учётные записи учеников, активное чтение и поддержку Python 3.14.

  • Breaking: Ломает совместимость: обновлены URL-маршруты и пространства имён WebSocket, старые точки входа удалены.
  • Added: Появились учётные записи учеников с контролем возраста и кураторским циклом для родителей.
  • Added: Режим чтения стал активным: добавлены цитаты, заметки, перевод и квизы на основе источников.
  • Added: Улучшена работа с длинными задачами: генерация книг и чат теперь корректно ставятся на паузу и возобновляются.
  • Added: Добавлена поддержка Python 3.14, движка DashScope и интеграции с WeKnora без локальной индексации.
v1.6.2minorbreaking
🕐 21 дн назад · релиз на GitHub ↗

DeepTutor v1.6.2: интеграция YouTube, визуализаторы, обновление Home/Reading/Knowledge и удаление устаревших API.

  • Added: Добавлен режим обучения с синхронизацией видео YouTube и Invidious.
  • Added: Визуализация теперь поддерживает SVG, Mermaid, Chart.js, Manim и GeoGebra через каталоги плагинов.
  • Added: Расширены возможности MinerU для обработки изображений, DOCX, PPTX и XLSX.
  • Added: В My Agents добавлены агенты Hermes, OpenClaw и DeepSeek Harness.
  • Breaking: Удалены Playground API и поддержка Gemini CLI в качестве хабса агентов.
v1.6.1minor
🕐 22 дн назад · релиз на GitHub ↗

DeepTutor v1.6.1: единые подключения для ключей, навигация настроек, LightRAG как первый класс и улучшение сайдбара.

  • Added: Внедрены подключения (connections): единый ключ провайдера, применяемый ко всем сервисам, вместо дублирования в каждом профиле.
  • Added: Появились модели задач (task models) для именования диалогов и генерации подсказок, независимые от основной модели рассуждений.
  • Added: LightRAG интегрирован как первый класс: прямой вызов SDK, исключение MinerU из зависимостей и сохранение неопределенных кандидатов.
  • Added: Полный редизайн настроек: поиск и навигатор вместо сетки карточек, сохранение черновиков при переходе между страницами.
  • Added: Улучшен сайдбар: сортировка перетаскиванием, группировка диалогов по темам изучения и единая панель чтения документов.
  • Fixed: Исправлены биндинги OpenAI (web search, flash thinking), Anthropic SDK 1.x, роли Jina, обработка ошибок парсинга PDF и безопасность файлов.
v1.6.0majorbreaking
🕐 25 дн назад · релиз на GitHub ↗

DeepTutor v1.6.0: полноценный читатель EPUB, курсы, приватные книги с редактурой и синхронизация документаций.

  • Added: EPUB-читатель с сохранением позиции, аннотациями Recogito и формат-ориентированным оглавлением.
  • Added: Курсы, вложенные потоки Little Tutor и режим Ask Questions с уточняющими карточками.
  • Added: Знаниевые базы отслеживают документационные сайты; Serply и OpenAI Search для веб-поиска.
  • Added: Общие книги: приватный прогресс, оптимистичная блокировка при редактировании, контроль доступа.
  • Fixed: Изоляция сбоев расширений, стабильность аннотаций, очистка Windows-совместимости и TLS.
  • Breaking: Админские книги по умолчанию закрыты; требуется ручное назначение доступа в /admin/users.
v1.5.17minorbreaking
🕐 27 дн назад · релиз на GitHub ↗

Партнеры теперь приватны для пользователей, добавлена поддержка Antigravity CLI и интеграция с GitHub.

  • Breaking: Партнеры теперь принадлежат пользователям, а не деплою; права доступа разделены на управление, использование и просмотр.
  • Added: Чат-аккаунты (QQ, Telegram) можно связать с личным аккаунтом DeepTutor для приватных бесед и доступа к личной памяти.
  • Added: Добавлена поддержка Antigravity CLI (agy) как отдельного бэкенда на смену устаревшему Gemini CLI.
  • Added: Появилась функция отслеживания GitHub-репозиториев в базе знаний с автоматической синхронизацией Markdown.
  • Added: QR-код для входа в WeChat генерируется в браузере, а не выводится в консоль сервера.
  • Added: Изолировано состояние каналов для каждого партнера, позволяя нескольким ботам работать на одном канале без конфликтов.
v1.5.16minor
🕐 1 мес назад · релиз на GitHub ↗

DeepTutor v1.5.16: поддержка MarginNote 4, исправление прокрутки книг и стабильности вызовов инструментов.

  • Added: Добавлена поддержка MarginNote 4 в качестве источника знаний с чтением заметок и карт без индексации.
  • Fixed: Восстановлена прокрутка страниц книги, сломанная предыдущим обновлением из-за ошибки верстки.
  • Fixed: Исправлено бесконечное увеличение ID и имени инструментов, приводившее к ошибкам провайдеров.
  • Fixed: Настройки температуры теперь корректно применяются на основе спецификации модели, а не привязки.
  • Fixed: Улучшена обработка ошибок в LightRAG и добавлен параллельный анализ изображений в индексе.
v1.5.15minor
🕐 1 мес назад · релиз на GitHub ↗

OSS PageIndex, банк вопросов, плагины, Tika, LightRAG UI, фиксы дерева файлов и Whisper.

  • Added: PageIndex OSS: локальная база знаний с извлечением по дереву документов без API-ключа.
  • Added: Банк вопросов: поиск, массовый выбор, папка входящих и инструмент organize для авто-сортировки.
  • Added: Поддержка плагинов: регистрация инструментов и возможностей через deeptutor.plugins и loop_capabilities.
  • Added: Apache Tika: удалённый парсер документов в Markdown через TIKA_SERVER_URL.
  • Added: Настройки LightRAG: UI-контролы для max_concurrent_files и других параметров индексации.
  • Fixed: Исправлено сжатие поддиректорий, дублирование файлов и добавлена выборка целевой папки при загрузке.
v1.5.14major
🕐 1 мес назад · релиз на GitHub ↗

DeepTutor v1.5.14: иммерсивное чтение с цитированием страниц, автоконфигурация через чат, редактируемая библиотека Tencent IMA и консоль для ноутбуков.

  • Added: Immersive Reading: документ открывается рядом с чатом, ответы содержат точные ссылки на страницы, поддерживается экспорт аннотированного PDF.
  • Added: Автоконфигурация через чат: ассистент может менять настройки, устанавливать парсеры и модели, соблюдая строгие правила безопасности ключей.
  • Added: Tencent IMA: библиотека теперь доступна для просмотра, чтения полных источников и записи заметок, а не только поиска.
  • Fixed: Восстановлен поиск по подключенным базам знаний (Obsidian, LightRAG, IMA), которые ошибочно игнорировались в предыдущей версии.
  • Added: Ноутбуки перенесены в отдельную консоль с атомарными сохранениями, защитой от конфликтов и исправлением потери связей при переименовании.
v1.5.13minor
🕐 1 мес назад · релиз на GitHub ↗

DeepTutor v1.5.13: экспорт книг, точная оценка стоимости генерации, исправление прогресса чтения и улучшенная работа с базами знаний.

  • Added: Книги можно экспортировать в Markdown, прогресс чтения и закладки теперь корректно сохраняются, а компиляция работает стабильно при перезагрузке страницы.
  • Added: Редактор показывает точную оценку стоимости генерации в реальном времени и исправляет проблемы двойной оплаты и зависания при сбоях провайдера.
  • Fixed: Подключенные базы знаний (Obsidian, LightRAG, IMA) теперь корректно участвуют в поиске, а учетные данные IMA централизованы на уровне аккаунта.
  • Added: Главный экран предлагает три варианта начала работы на основе истории действий, а пути мастерства синхронизируются с контекстом беседы.
  • Added: Добавлена поддержка формата EPUB в качестве базы знаний и возможность удаленного парсинга через Docling Serve без локальной установки.
v1.5.12minor
🕐 1 мес назад · релиз на GitHub ↗

Переработан поиск с шестью новыми провайдерами, улучшена отказоустойчивость и парсинг документов.

  • Added: Поисковый слой переписан на единую таблицу; добавлены провайдеры Doubao, Bocha, Zhipu, Firecrawl, Baidu Qianfan и Aliyun IQS.
  • Fixed: Сбой поиска больше не прерывает ответ: система автоматически переключается на другие провайдеры с фиксацией в логах.
  • Added: Добавлен движок LiteParse для легковесного парсинга документов без загрузки локальных моделей.
  • Fixed: MCP-серверы теперь корректно переподключаются при смене учетных данных; улучшена обработка ошибок аутентификации.
  • Added: Добавлены провайдеры CodeBuddy/WorkBuddy и OrcaRouter; Codex получил поддержку зрения и сохранение настроек рассуждений.
v1.5.11minor
🕐 1 мес назад · релиз на GitHub ↗

Исправлена потеря текста при вызовах инструментов, улучшена обработка обрывов генерации и локального индексирования LightRAG

  • Fixed: Текст вокруг вызовов инструментов больше не теряется благодаря потоковой фильтрации DSML-разметки
  • Fixed: Аргументы массивов и объектов в DSML корректно декодируются на основе схемы инструмента
  • Fixed: Обрезанные генерации теперь запрашивают продолжение, а не завершаются досрочно
  • Added: В настройках добавлена панель с реальным потреблением памяти процесса DeepTutor
  • Fixed: Локальное индексирование LightRAG вынесено в поток, чтобы не блокировать основной цикл событий
  • Fixed: Валидация вопросов Mastery теперь опирается на сохраненную структуру, а не на перефразирование модели
v1.5.10minor
🕐 1 мес назад · релиз на GitHub ↗

Добавлена авторизация Codex для пользователей, язык ответов модели и исправления стабильности.

  • Added: Пользователи могут самостоятельно подключать свой Codex через Models → LLM.
  • Added: Язык ответов модели вынесен в отдельную настройку в разделе Appearance.
  • Fixed: Заблокирован бесконечный цикл при вызове инструментов с пустыми аргументами.
  • Fixed: Исправлено зависание интерфейса при пакетной загрузке файлов и построении списка KB.
  • Added: Deep Research теперь напрямую работает с подключенным хранилищем Obsidian.
  • Fixed: Исправлено подключение к бэкенду на хостах с двойным стеком IPv4/IPv6.
v1.5.9minorbreaking
🕐 1 мес назад · релиз на GitHub ↗

DeepTutor v1.5.9: новые провайдеры, фикс ролей запросов, контроль рассуждений и миграция данных для Docker.

  • Breaking: Пользователям docker-compose.ghcr.yml необходимо выполнить миграцию данных перед обновлением.
  • Added: Добавлена поддержка Gemini Embedding 2 через нативный API и шлюза Novita AI.
  • Added: Внедрен контроль глубины рассуждений (reasoning-effort) для моделей и исправлены баги с переключением мышления.
  • Fixed: Запросы теперь правильно маркируются как search_query, а не как документы.
  • Fixed: Исправлен вывод ошибок: теперь они отображаются в интерфейсе, а не остаются пустыми.
v1.5.8minorbreaking
🕐 1 мес назад · релиз на GitHub ↗

Релиз v1.5.8: оптимизация потребления памяти, переключение на продакшн-сборку фронтенда и исправление сетевых таймаутов.

  • Fixed: Решена проблема утечки памяти: добавлены лимиты для кэшей, пула HTTP-клиентов и потоков логов задач.
  • Breaking: Команда deeptutor start теперь запускает продакшн-сборку; для горячей перезагрузки используйте флаг --dev.
  • Fixed: Исправлено падение запросов с ошибкой 500 из-за гонки таймаутов keep-alive между Node.js и uvicorn.
  • Fixed: Настроена корректная передача лимита памяти V8 в воркер Next.js и добавлен вызов malloc_trim для возврата памяти ОС.
  • Breaking: Запуск python -m deeptutor.api.run_server больше не включает автоперезагрузку; для неё нужен переменная DEEPTUTOR_DEV_RELOAD=1.
v1.5.0major
🕐 2 мес назад · релиз на GitHub ↗

DeepTutor v1.5.0: агентная платформа с мультиканальными партнёрами, обновлённым RAG, обучением и усиленной безопасностью.

  • Added: Платформа Partners: IM-пайплайн для 15+ каналов (Slack, Discord, Telegram и др.) с живыми ответами и приватной памятью.
  • Added: Единый агентный движок чата с нативным вызовом инструментов для OpenAI-совместимых провайдеров (Gemini 2.5+, Qwen, MiniMax M3).
  • Added: Центр знаний на базе LlamaIndex, FAISS, LightRAG и GraphRAG с поддержкой MinerU, Docling и других парсеров документов.
  • Added: Режим Guided Learning и Mastery Path с дашбордом /learning, LaTeX-квизами и интеграцией с банком вопросов.
  • Added: Полная изоляция пользователей, управление профилями с аватарами, deny-by-default для MCP-инструментов и сессий.
  • Fixed: Исправлены критические уязвимости (RCE, path-traversal), улучшена безопасность песочницы инструментов и стабильность работы.
v1.4.15minor
🕐 2 мес назад · релиз на GitHub ↗

Релиз DeepTutor v1.4.15: нативная интеграция Mattermost, исправление оценки тестов и корректная работа chunk_overlap=0.

  • Added: Добавлена нативная поддержка Mattermost через WebSocket и REST API без использования Slack-шлюза.
  • Fixed: Исправлено сохранение и корректная проверка ответов в тестах Mastery Path с множественным выбором.
  • Fixed: Настройка chunk_overlap=0 теперь корректно применяется при индексации, а не заменяется значением по умолчанию.