Quick Start

Choose a quick-start path based on your TTS provider preference.

Option 1: Cloud TTS (Easiest)

No Docker required. Use OpenAI, AWS Polly, or Google Cloud TTS.

1. Install Audify

pip install audify-cli

2. Configure credentials

Create a .keys file in your working directory:

# OpenAI TTS (simplest cloud option)
OPENAI_API_KEY=sk-your-openai-api-key
TTS_PROVIDER=openai

3. Convert a book

audify run book.epub --tts-provider openai

Option 2: Kokoro TTS (Local, Free)

Requires Docker and a CUDA GPU. Fast and low-latency synthesis.

1. Clone and start services

git clone https://github.com/garciadias/audify.git
cd audify
docker compose up -d
# Wait ~2-3 minutes for services to start

2. Pull an Ollama model

docker compose exec ollama ollama pull qwen3:30b

3. Convert a book

uv sync
audify run book.epub

Option 3: Qwen-TTS (Local, Free)

Requires GPU and the Qwen-TTS API server. Offers multilingual support and high-quality synthesis.

1. Start Qwen-TTS

git clone https://github.com/QwenLM/Qwen3-TTS
cd Qwen3-TTS
make up
# API available at http://localhost:8890

2. Install and configure Audify

pip install audify-cli

Create a .keys file:

TTS_PROVIDER=qwen
QWEN_API_URL=http://localhost:8890
QWEN_TTS_VOICE=Vivian

3. Convert a book

audify run book.epub --tts-provider qwen

Next Steps