Перевод английской EPUB-книги на русский

В этом посте я расскажу, как перевести английскую книгу EPUB с помощью локальной LLM (Ollama). Весь процесс выполняется на одной машине.

В качестве примера используется книга Элеанор Прей "Письма из Владивостока".

Замечание. Процесс ресурсоёмкий: перевод книги среднего размера локальной моделью занимает примерно 18–24 часа. Желательно иметь GPU и достаточно RAM для модели Ollama.

Предварительные требования

Ollama сервер с установленной моделью gemma4:26b.

Папки будущего проекта

/opt/epub-translate/
├── venv/                 # python venv, pip модули
├── input/                # оригинальный файл .epub
├── work/                 # распакованный файл
├── progress/             # checkpoint.json
├── output/               # translated .epub
├── 01_inspect.py         # распаковка epub + статистика сегментов/слов
├── 02_translate.py       # перевод
└── 03_repackage.py       # запаковка EPUB

sudo mkdir -p /opt/epub-translate/{input,work,progress,output}
sudo chown -R "$USER":"$USER" /opt/epub-translate

Установка виртуального окружения Python

python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip
pip install beautifulsoup4 lxml ollama

Копирование оригинального файла

cp "/path/to/Letters from Vladivostock, 1894-1930 -- Eleanor Lord Pray.epub" input/

Распаковка EPUB файла

python 01_inspect.py