ElevenLabs Voice Personas v2.1.5

High-quality voice synthesis with 18 personas, 32 languages, sound effects, and voice design.

Quick Start

First time? Run the setup wizard:

python3 scripts/setup.py

This guides you through API key configuration, voice selection, and preferences. Your settings are stored locally in config.json (never shared, always in .gitignore).

Or set your API key manually:

export ELEVEN_API_KEY="your-key-here"

Then start using:

# Basic TTS
python3 scripts/tts.py --text "Hello world" --voice rachel
 
# Multi-language
python3 scripts/tts.py --text "Bonjour!" --voice rachel --lang fr
 
# Sound effects
python3 scripts/sfx.py --prompt "Thunder rumbling"
 
# Batch processing
python3 scripts/tts.py --batch texts.txt --voice adam --output-dir ./audio
 
# Usage stats
python3 scripts/tts.py --stats

Features

Feature	Command
TTS	`python3 scripts/tts.py --text "..." --voice NAME`
Languages (32)	`--lang de` (German), `--lang fr` (French), etc.
Streaming	`--stream`
Batch	`--batch file.txt --output-dir ./out`
Sound Effects	`python3 scripts/sfx.py --prompt "..."`
Voice Design	`python3 scripts/voice-design.py --gender female --age young`
Cost Stats	`--stats`

Voice Presets

narrator - Documentary style
storyteller - Audiobooks
professional - Corporate
educator - Tutorials
calm - Meditation
energetic - Social media
broadcaster - News

Documentation

SKILL.md - Full documentation
examples.md - Usage examples
voices.json - Voice configurations
pronunciations.json - Custom pronunciations

License

MIT - See ElevenLabs terms for API usage.