This is a command-line tool to translate EPUBs using multilingual transformer models. Processing runs locally and requires a GPU.
| Features |
|---|
| 200+ languages |
| Choose from several models |
| Unrestricted offline translation |
| Create bilingual ebooks |
| Retains ebook formatting |
Currently, the output quality is comparable to Google Translate and DeepL.
Because translating an entire book is lengthy, test the model on a sample first.
A test sample is included in tests/resources/.
As you would expect, the quality is better between closely related languages.
These are the latest supported models. Quantized versions are used to reduce the size and RAM requirements.
| Model | Parameters | Languages | Size | Technology | Notes |
|---|---|---|---|---|---|
| NLLB200 | 1.3B | 200 | 1.3 GB | CTranslate2 | |
| small100 | 330M | 100 | 0.6 GB | SentencePiece, bitsandbytes | Only Intel CPUs |
AI evolves quickly. You are welcome to suggest a new state-of-the-art multilingual model that could be added.
- CUDA graphics card (Nvidia) or ROCm graphics card (AMD)
- python
AMD compatibility additionally depends on the operating system.
Though it has not been tested, you may need to install the ROCm drivers.
Setup (first time)
- download the source code from a release, move it to your preferred location
- open terminal in the unzipped folder
pip install -r requirements.txt- downloads dependenciespython ui.pyorpython3 ui.py- starts the program
Update to the new version
- delete the (release) folder
- download a new release, move it to your preferred location
- open terminal in the unzipped folder
- optionally:
pip install -r requirements.txt- updates dependencies
Uninstall
- check where the program data is located (About menu in the program)
- delete both the program data and source code folders
- optionally: uninstall pip dependencies in requirements.txt
Could not find a version that satisfies the requirement ctranslate2
Select the version for your system and install it: pip install ctranslate2-<version>-<python_version>-<platform>.whl.
You may then remove ctranslate2 from requirements.txt.
No package metadata was found for bitsandbytes
Reinstall to a compatible version:
pip install --force-reinstall 'https://github.com/bitsandbytes-foundation/bitsandbytes/releases/download/continuous-release_multi-backend-refactor/bitsandbytes-0.44.1.dev0-py3-none-win_amd64.whl'
Any other issues
If you have compatible system, you should be able to resolve these issues by following the crash log messages and installing the compatible versions of dependencies. Otherwise, let me know.
Feedback
I appreciate any bug reports: EPUB formatting, translation, installation etc. Please use the issue tracker or discussions.