Metadata-Version: 2.4
Name: recito
Version: 0.8.3
Summary: Convert PDF or eBook to audio speech file using AI text to speech
Author: Jeff Moe
License-Expression: AGPL-3.0-or-later
Project-URL: Homepage, https://recito.org
Project-URL: Source, https://spacecruft.org/books/recito
Keywords: audiobook,ebook,epub,m4b,pdf,speech-synthesis,text-to-speech,tts
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: GPU :: NVIDIA CUDA
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Sound Synthesis
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: pymupdf>=1.24
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: typer>=0.12
Requires-Dist: pysbd>=0.3.4
Requires-Dist: num2words>=0.5.13
Requires-Dist: soundfile>=0.13
Requires-Dist: numpy>=1.26
Requires-Dist: qwen-tts<0.2,>=0.1.1
Requires-Dist: torch>=2.8
Requires-Dist: faster-whisper<1.3,>=1.2.1
Requires-Dist: ctranslate2<5,>=4.8.2
Requires-Dist: tokenizers<1,>=0.22.2
Requires-Dist: huggingface_hub<1,>=0.36.2
Requires-Dist: python-dotenv>=1.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# recito

recito turns a PDF or EPUB ebook into an audiobook you can listen to
anywhere — narrated entirely on your own machine (an unpacked-epub
directory, such as an ebook source tree, works too). It exists so that
listening to a book you own doesn't mean renting a cloud narrator: no
accounts, no uploads, no per-hour fees, nothing leaves your computer.
The voice is an open-weight AI model and recito itself is free software.

Project page: [recito.org](https://recito.org)
Source: [spacecruft.org/books/recito](https://spacecruft.org/books/recito)

recito reads PDFs the way a person does — two-column layouts, running
headers, watermarks and page numbers are all handled — and epubs are
read chapter by chapter, following the book's own table of contents.
Numbers and abbreviations are spoken properly ("$3.5mn" is read as
"three point five million dollars"). And every passage is checked by
listening back to it: anything that comes out wrong is re-narrated
automatically. The result is a single `.m4b` file with chapters, title,
author and cover art, ready for any audiobook player.

## What you need

- A computer with an **NVIDIA graphics card** (about 8 GB of video
  memory)
- **Python 3.12** and **ffmpeg**
- About **5 GB of disk space** for the voice model, downloaded once on
  first use

## Install

```
pip install recito
```

Best in a virtualenv. Detailed setup and other ways to install:
[the install guide](https://spacecruft.org/books/recito/src/branch/main/docs/INSTALL.md).

## Quick start

```
recito speak mybook.pdf
```

A while later, `mybook-ryan.m4b` sits next to the book. If anything
interrupts the render, run the same command again — finished parts are
never redone.

`ryan` is the default voice; `recito voices` lists all nine and
`--voice serena` picks another. To check the narration before
committing to a whole book, skim the text it will read (fast, no GPU
needed), or render a single page:

```
recito extract mybook.pdf --dump-text mybook.txt
recito speak mybook.pdf --voice serena --pages 10 -o preview.m4b
```

You can also narrate in your own voice from a few seconds of clean audio
(`--voice clone:ref.wav`), and books in German, French, Spanish,
Italian, Russian, Chinese and Japanese work with `--language`.

## Learn more

- [Usage guide](https://spacecruft.org/books/recito/src/branch/main/docs/USAGE.md)
  — voices and cloning, other languages, reading part of a book, other
  output formats, per-book settings, covers and titles, troubleshooting
- [Install guide](https://spacecruft.org/books/recito/src/branch/main/docs/INSTALL.md)
- For developers: [DEVELOP.md](https://spacecruft.org/books/recito/src/branch/main/docs/DEVELOP.md)
  (internals), [ISSUES.md](https://spacecruft.org/books/recito/src/branch/main/docs/ISSUES.md)
  (known bugs), [FUTURE.md](https://spacecruft.org/books/recito/src/branch/main/docs/FUTURE.md)
  (planned features), [TTS.md](https://spacecruft.org/books/recito/src/branch/main/docs/TTS.md)
  (voice engines)

## License

AGPL-3.0-or-later. See
[LICENSE.txt](https://spacecruft.org/books/recito/src/branch/main/LICENSE.txt).

**Copyright © 2026 Jeff Moe** — Loveland, Colorado, USA
