kenkui 1.0.0

Convert Ebooks to Audiobooks with [custom] voice samples

kenkui

Freaky fast audiobook generation from EPUBs. No GPU. No nonsense.

kenkui turns EPUB ebooks into high-quality M4B audiobooks using state-of-the-art text-to-speech — entirely on CPU, and faster than anything else I've used.

It's built on top of Kyutai's pocket-tts, with all the annoying parts handled for you: chapter parsing, batching, metadata, covers, voices, and sane defaults.

If you have ebooks and want audiobooks, kenkui is for you.

---

✨ Features

• Freaky fast audiobook generation
• No GPU needed, 100% CPU
• Super high-quality text-to-speech
• Multithreaded
• EPUB-aware chapter parsing
• Flexible chapter filtering with regex patterns and presets
• Custom voices
• Batch processing
• Automatic cover embedding (EPUB → M4B)
• Sensible defaults, minimal configuration

---

🚀 Quick Start

kenkui is intentionally easy to install and easy to use.

One-line installer (macOS / Linux)

curl -sSL https://raw.githubusercontent.com/D1zzl3D0p/kenkui/main/install.sh | bash

One-line installer (Windows)

powershell -Command "irm https://raw.githubusercontent.com/D1zzl3D0p/kenkui/main/install.ps1 | iex"

Requirements

• Python 3.12+
• One Python installer: uv (recommended), pip, or pipx

Manual install

uv tool install kenkui

Or with pip/pipx:

pip install kenkui
# or
pipx install kenkui

Run

kenkui book.epub

That's it. You'll get a book.m4b alongside your EPUB.

You can also point Kenkui at a directory, and it will recursively convert all EPUBs it finds. Running without arguments searches the current directory and all subdirectories.

---

📚 Usage

You can pass either a single EPUB file or a directory.

# Convert a single book
kenkui book.epub

# Convert an entire library (interactive book selection)
kenkui library/

# Convert all books without prompting
kenkui library/ --no-select-books

# Specify output directory
kenkui book.epub -o output/

# Log detailed output to file
kenkui book.epub --log conversion.log

# Debug mode with full logging
kenkui book.epub --log debug.log --verbose

🎙️ Voice Selection

Use -v or --voice to choose a voice.

Accepted inputs:

• One of pocket-tts's default voices:

  alba, marius, javert, jean, fantine, cosette, eponine, azelma
  

• A local .wav file

• A Hugging Face-hosted voice:

  hf://user/repo/voice.wav
  

To see everything Kenkui can currently use:

kenkui --list-voices

🎭 Custom Voices

To use your own voice, record a 5–10 second clip of clean speech with minimal background noise or crosstalk.

Cleaning the audio makes a noticeable difference. Tools like Adobe's Enhance Speech work well: https://podcast.adobe.com/en/enhance

---

FAQ

Do I need a GPU?
No. kenkui is 100% CPU-based.

Is it actually fast?
Yes. That's the entire point of the project.

What output format does it use?
M4B, with chapters, metadata, and embedded covers.

Can it generate MP3s?
No. This is intentional — M4B is a significantly better format for audiobooks.

Does it support formats other than EPUB?
Not currently. EPUB only, for now.

Why do I need to log in to Hugging Face for custom voices?
The pocket-tts model that powers kenkui is hosted on Hugging Face and is "gated," meaning the authors require users to accept their terms of use before downloading it. This is a one-time setup that takes about 2 minutes.

When you first use a custom voice (anything other than the 8 built-in defaults), kenkui will guide you through:

1. Creating a free Hugging Face account (if you don't have one)
2. Generating a read-only access token
3. Accepting the model's terms of use

The process is interactive and will open your browser at the right pages. You only need to do this once.

Does it upload my books anywhere?
No. Everything runs locally. Internet access is only needed if you pull voices from Hugging Face.

Why isn't Kenkui finding my EPUB in a hidden directory?
Kenkui doesn't search hidden directories by default. If you have books in hidden folders, pass the file directly instead of the directory:

kenkui /path/to/hidden/directory/book.epub

---

Non-Goals

kenkui is not meant to be:

• A general-purpose text-to-speech framework
• A GUI application
• An MP3 audiobook generator
• A pluggable frontend for every TTS backend available

The focus is narrow by design: fast, high-quality audiobook generation from EPUBs, with minimal friction.

---

🙏 Special Thanks

Thanks to Project Gutenberg for providing some of the public-domain books included with Kenkui.