Нейросеть для перевода текста целой книги: open-source конвейер BookTrans делает это за часы

Разработчик Сергей Каменев опубликовал на GitHub проект BookTrans. Это конвейер с открытым исходным кодом, который берёт книгу в формате epub и переводит её целиком с помощью больших языковых моделей. Проект поддерживает три агента: Claude Code, Antigravity CLI и Codex. Автор создал инструмент, потому что не смог найти русский перевод нескольких научно-фантастических романов и понял, что ручное копирование текста в веб-версию LLM (большой языковой модели, которая генерирует текст) занимает недопустимо много времени.

Почему веб-чат не справляется с книгой?

Даже если модель принимает роман целиком, ограничение на длину ответа не позволяет уместить перевод в одно сообщение. На длинном тексте внимание модели к деталям падает: она начинает пропускать абзацы.

Автор описывает случай, когда знакомый переводил книгу постранично: фотографировал страницы, загружал снимки в Gemini, получал результат. Процесс тянулся неделями. BookTrans решает эту задачу иначе: разбивает книгу на управляемые фрагменты, переводит их последовательно и передаёт контекст от главы к главе.

Что понадобится

• Книга в формате epub на языке оригинала
• Платная подписка на один из поддерживаемых агентов: Claude Code, Antigravity CLI или Codex
• Python и менеджер пакетов (автор рекомендует uv для виртуального окружения)
• Терминал (командная строка) и базовое умение запускать команды
• Время: от нескольких часов, зависит от объёма книги и скорости модели

Пошаговая инструкция

1. Установите проект. Два варианта на выбор. Через клонирование репозитория:

git clone https://github.com/sukamenev/booktrans

Или через менеджер пакетов:

pipx install booktrans

1. Выберите агента. В проекте три обёртки с готовыми профилями настроек:
2. bt_agy для Antigravity CLI
3. bt_claude для Claude Code

4. bt_codex для Codex

5. Запустите перевод. Укажите файл книги, целевой язык и язык интерфейса:

uv run ./booktrans/bt_agy source_book.epub --to ru --ui ru

Параметр --to ru задаёт русский как язык перевода, --ui ru переключает интерфейс на русский.

1. Дождитесь этапа разведки. Конвейер сначала проверяет файл: определяет язык по абзацам, проверяет кодировку, оценивает объём текста. Затем модель анализирует структуру epub и распознаёт, какие теги и классы соответствуют заголовкам, прозе и цитатам.

2. Конвейер составит глоссарий автоматически. Перед переводом нейросеть для перевода текста просматривает всю книгу и формирует единый справочник: описание мира, персонажей, терминов. Для каждого персонажа фиксируются возраст, пол, отношения, особенности речи. Каждому сложному слову назначается один вариант перевода. Этот справочник попадает в каждый запрос, чтобы имя героя не превращалось в три разных варианта на протяжении книги.

3. Перевод идёт последовательно, глава за главой. Конвейер не запускает главы параллельно. Перед каждой следующей главой модель получает пересказ предыдущих, чтобы учитывать развитие сюжета и изменения персонажей. Когда конспект разрастается, отдельный проход его сжимает.

4. Слепая редактура. Готовый перевод проходит литературную правку. Редактор (отдельный проход модели) не видит оригинала на английском. Это сделано намеренно: по наблюдению автора, доступ к оригиналу заставляет модель-редактора чаще сохранять кальки с английского. Черновик остаётся нетронутым, все правки можно просмотреть перед финальной сборкой.

5. Проверьте результат. Откройте готовый epub и пройдитесь по проблемным местам: стихи (конвейер распознаёт их отдельно и переводит стихами), сноски к сложным терминам, пометки об ошибках оригинала.

Как конвейер работает с ошибками и сносками?

Если в оригинале обнаруживается фактическая ошибка или нестыковка, конвейер сохраняет её в переводе, а правильный вариант (по мнению модели) добавляет в сноску. Автор объясняет этот подход так: задача переводчика состоит в точной передаче авторского текста, а тихая правка прячет от читателя решение переводчика.

Сноски также используются для непонятных слов: редких научных терминов, устаревшей лексики, исторических имён.

uv run ./booktrans/bt_claude my_scifi_novel.epub --to ru --ui ru

Что делать с этим прямо сейчас, по ролям

Автору на Дзене. Если вы пишете обзоры зарубежных книг или ведёте книжный канал, BookTrans позволяет прочитать непереведённую новинку и подготовить материал раньше конкурентов. Глоссарий, который составляет конвейер, пригодится для терминологически точных рецензий.

Маркетологу. Принцип конвейера (разведка, глоссарий, последовательный перевод, слепая редактура) применим не только к книгам. Длинные отчёты, white papers, техническую документацию можно переводить по той же схеме, сохраняя единство терминов бренда.

Предпринимателю в РФ и СНГ. Для запуска нужна платная подписка на один из зарубежных агентов (Claude Code, Codex или Antigravity CLI). Из доступных в РФ аналогов для перевода коротких текстов подойдут YandexGPT и GigaChat, но конвейера с автоматическим глоссарием и последовательным контекстом у них пока нет. BookTrans работает через API, доступ к которому из России может потребовать дополнительных шагов.

Автоматический перевод книг перестал быть задачей для терпеливых энтузиастов с веб-чатом. Если вас блокирует отсутствие русского перевода нужной книги, попробуйте BookTrans на коротком тексте, оцените качество глоссария и редактуры, а потом решайте, стоит ли запускать на полный роман.