abogen logo

abogen

denizsafak/abogen

Generate audiobooks from EPUBs, PDFs and text with synchronized captions.

GraphCanon updated 3w · GitHub synced 3w

5.4k stars398 forksLast push 1mo Python MIT

Decision brief

abogen generates audiobooks with synchronized captions from ebooks in multiple languages using speech synthesis technologies, suitable for content creators who need to add auditory experiences to text-based media.

Good fit when

  • You require comprehensive support for both English and non-English voices, including Japanese and Mandarin Chinese
  • You need a tool that supports GPU acceleration via Docker with the NVIDIA Container Toolkit

Avoid when

  • For use cases requiring minimal setup without the need to install Kokoro's development version or espeak-ng separately
  • If your project strictly limits external dependencies to pre-installed packages, as abogen requires additional installs beyond pip

Observed Jul 17, 2026 · Source: enrich:decision_facts

Verify the decision

Maintenance and security

Full trust report
Maintenance
Very active (5d since push)
As of 3w
Provenance
Not a fork · Personal account
As of 3w
Security (OSV)
No lockfile
As of 1mo

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

pip install abogen
PyPI

Similar tools

Same-category neighbours. No typed graph edges are catalogued for this tool yet.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

abogen is an open-source tool for generating audiobooks with synchronized captions from ebooks and other textual formats using speech synthesis technologies like Kokoro TTS system and espeak-ng.

Capability facts

CLI
CLI entrypoint

Source: pyproject.toml:[project.scripts] · Jul 29, 2026

Languages
python

Source: github.language+pyproject.toml · Jul 29, 2026

Categories

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

Python runtimePython

Source: README excerpt (regex_v1, Jul 29, 2026)

src="https://img.shields.io/pypi/pyversions/abogen" alt="Abogen Compatible PyPi Python Versions" align="right" style="margin-top:6px;"></a>
Source link

Tags

README

How to install? Abogen Compatible PyPi Python Versions


Install abogen

pip install abogen


</details>

---

# Install espeak-ng
brew install espeak-ng

---

# After installing abogen, we need to install Kokoro's development version which includes MPS support.
pip3 install git+https://github.com/hexgrad/kokoro.git

Install espeak-ng

sudo apt install espeak-ng # Ubuntu/Debian sudo pacman -S espeak-ng # Arch Linux sudo dnf install espeak-ng # Fedora


Already supported, no need to install CUDA separately.


Docker Compose (GPU by default)

The repo includes docker-compose.yaml, which targets GPU hosts out of the box. Install the NVIDIA Container Toolkit and run:

docker compose up -d --build

Key build/runtime knobs:

  • TORCH_VERSION – pin a specific PyTorch release that matches your driver (leave blank for the latest on the configured index).
  • TORCH_INDEX_URL – swap out the PyTorch download index when targeting a different CUDA build.
  • ABOGEN_DATA – host path that stores uploads/outputs (defaults to ./data).

CPU-only deployment: comment out the deploy.resources.reservations.devices block (and the optional runtime: nvidia line) inside the compose file. Compose will then run without requesting a GPU. If you prefer the classic CLI:

docker build -f abogen/Dockerfile -t abogen-gpu .
docker run --rm \
  --gpus all \
  -p 8808:8808 \
  -v ~/abogen-data:/data \
  abogen-gpu

🇯🇵 'j' => Japanese: pip install misaki[ja]


🇨🇳 'z' => Mandarin Chinese: pip install misaki[zh]

For a complete list of supported languages and voices, refer to Kokoro's [VOICES.md](https://huggingface.co/hexgrad/Kokoro-82M/blob/main/VOICES.md). To listen to sample audio outputs, see [SAMPLES.md](https://huggingface.co/hexgrad/Kokoro-82M/blob/main/SAMPLES.md).

> See [How to fix Japanese audio not working?](#japanese-audio-not-working)

---

---

## `License`
This project is available under the MIT License - see the [LICENSE](https://github.com/denizsafak/abogen/blob/main/LICENSE) file for details.
[Kokoro](https://github.com/hexgrad/kokoro) is licensed under [Apache-2.0](https://github.com/hexgrad/kokoro/blob/main/LICENSE) which allows commercial use, modification, distribution, and private use.

For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.