A self-hosted, provider-agnostic web interface for chatting with local Ollama models and OpenAI-compatible APIs, with RAG, plugins and multi-user access control.
156.2K22.7KPythonOtherUpdated 2 days ago
hydropix/TranslateBooksWithLLMs
Desktop and CLI app that translates books, subtitles and documents (EPUB, SRT, DOCX, PDF, TXT) with local or cloud LLMs, resuming interrupted jobs.
Open-source alternative to:DeepL Translator
- Stars
- 2,528
- Forks
- 358
- Open issues
- 26
- Last commit
- 8 days ago
What is it?
TBL (Translate Books with LLMs) is a desktop app with a web interface and a command-line tool for translating full-length books, subtitles and documents. It accepts EPUB, SRT, DOCX, PDF and TXT files, splits them into chunks while keeping context between segments, and writes out a translated file in the same format.
It works with local models through Ollama or any OpenAI-compatible server such as LM Studio or vLLM, and with cloud providers including OpenAI, Gemini, Mistral, DeepSeek, OpenRouter, Poe and NVIDIA NIM. Progress is checkpointed so an interrupted job can resume where it stopped. Optional features include a glossary for consistent term translation, reusable writing-style presets, a refinement pass, text cleanup, and Edge-TTS audio generation.
EPUB styling, SRT timecodes and other tags are preserved. Text PDFs are rebuilt as a new reflowed PDF rather than keeping the original layout, and scanned PDFs are not supported because there is no OCR.
Key features
- 01Translates EPUB, SRT, DOCX, PDF and TXT files, with formatting and SRT timecodes kept intact.
- 02Runs with local models through Ollama or OpenAI-compatible servers, or with cloud APIs.
- 03Saves checkpoints so interrupted translations resume where they stopped.
- 04Supports glossaries and reusable style presets for consistent terminology and tone.
- 05Can rotate multiple API keys when a provider rate limit is hit.
- 06Offers a web UI, a CLI and a Docker image.
Use cases
- Translating a full-length novel or technical book into another language.
- Translating SRT subtitle files for films or video courses.
- Running translations entirely on a local machine with Ollama so no text leaves the computer.
- Batch-translating long documents overnight with cloud APIs and notifications on completion.
Quick start
- 1
Download the release zip for your platform from the releases page
- 2
Extract the archive
- 3
Run the app (TranslateBook.exe on Windows or ./TranslateBook on macOS)
./TranslateBook - 4
Open http://localhost:5000 in your browser
Things to know
- Free local use needs Ollama and a model that runs on your own hardware.
- Cloud providers require an API key, and their usage may cost money.
- Scanned PDFs are not supported because there is no OCR.
- The license is AGPL-3.0, which is copyleft and requires source disclosure for networked modifications.
Topics
FAQ
- What is TranslateBooksWithLLMs?
- Desktop and CLI app that translates books, subtitles and documents (EPUB, SRT, DOCX, PDF, TXT) with local or cloud LLMs, resuming interrupted jobs. TBL (Translate Books with LLMs) is a desktop app with a web interface and a command-line tool for translating full-length books, subtitles and documents. It accepts EPUB, SRT, DOCX, PDF and TXT files, splits them into chunks while keeping context between segments, and writes out a translated file in the same format.
- Is TranslateBooksWithLLMs free to use? What license does it have?
- TranslateBooksWithLLMs is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
- Is TranslateBooksWithLLMs still maintained?
- Actively maintained. The last commit to TranslateBooksWithLLMs was on Oct 13, 2026.
- What can I use TranslateBooksWithLLMs for?
- Translating a full-length novel or technical book into another language. Translating SRT subtitle files for films or video courses. Running translations entirely on a local machine with Ollama so no text leaves the computer. Batch-translating long documents overnight with cloud APIs and notifications on completion.
- How do I install TranslateBooksWithLLMs?
- Download the release zip for your platform from the releases page Extract the archive Run the app (TranslateBook.exe on Windows or ./TranslateBook on macOS): ./TranslateBook Open http://localhost:5000 in your browser
- Where can I get TranslateBooksWithLLMs?
- The source code and installation instructions are on GitHub: https://github.com/hydropix/TranslateBooksWithLLMs
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Free, open-source desktop app where AI agents work on your local files, built on OpenCode and usable with any model provider or local Ollama models.
24.2K2.5KTypeScriptOtherUpdated 4 hours ago
Open-source AI developer workspace that builds full-stack web apps in the browser, letting you pick any supported LLM per prompt.
20K10.6KTypeScriptMITUpdated 7 days ago
Docker Compose template that spins up a local AI and low-code stack with self-hosted n8n, Ollama, Qdrant and PostgreSQL.
15.3K3.8KApache-2.0Updated 9 days ago
An open-source AI answer engine that searches the web and returns cited answers with generative UI, built with Next.js and the Vercel AI SDK.
9.2K2.3KTypeScriptApache-2.0Updated 12 hours ago
A toolkit for compressing, deploying, and serving LLMs and vision-language models, with TurboMind and PyTorch inference engines.
8.1K767PythonApache-2.0Updated 4 hours ago