Pocket TTS Skill
Fully local, offline text-to-speech using Kyutai's Pocket TTS model. Generate high-quality audio from text without any API calls or internet connection. Features 8 built-in voices, voice cloning support, and runs entirely on CPU.
Features
- 🎯 Fully local - No API calls, runs completely offline
- 🚀 CPU-only - No GPU required, works on any computer
- ⚡ Fast generation - ~2-6x real-time on CPU
- 🎤 8 built-in voices - alba, marius, javert, jean, fantine, cosette, eponine, azelma
- 🎭 Voice cloning - Clone any voice from a WAV sample
- 🔊 Low latency - ~200ms first audio chunk
- 📚 Simple Python API - Easy integration into any project
Installation
# 1. Accept the model license on Hugging Face
# https://huggingface.co/kyutai/pocket-tts
# 2. Install the package
pip install pocket-tts
# Or use uv for automatic dependency management
uvx pocket-tts generate "Hello world"Usage
CLI
# Basic usage
pocket-tts "Hello, I am your AI assistant"
# With specific voice
pocket-tts "Hello" --voice alba --output hello.wav
# With custom voice file (voice cloning)
pocket-tts "Hello" --voice-file myvoice.wav --output output.wav
# Adjust speed
pocket-tts "Hello" --speed 1.2
# Start local server
pocket-tts --serve
# List available voices
pocket-tts --list-voicesPython API
from pocket_tts import TTSModel
import scipy.io.wavfile
# Load model
tts_model = TTSModel.load_model()
# Get voice state
voice_state = tts_model.get_state_for_audio_prompt(
"hf://kyutai/tts-voices/alba-mackenna/casual.wav"
)
# Generate audio
audio = tts_model.generate_audio(voice_state, "Hello world!")
# Save to WAV
scipy.io.wavfile.write("output.wav", tts_model.sample_rate, audio.numpy())
# Check sample rate
print(f"Sample rate: {tts_model.sample_rate} Hz")Available Voices
| Voice | Description |
|---|---|
| alba | Casual female voice |
| marius | Male voice |
| javert | Clear male voice |
| jean | Natural male voice |
| fantine | Female voice |
| cosette | Female voice |
| eponine | Female voice |
| azelma | Female voice |
Or use --voice-file /path/to/wav.wav for custom voice cloning.
Options
| Option | Description | Default |
|---|---|---|
text | Text to convert | Required |
-o, --output | Output WAV file | output.wav |
-v, --voice | Voice preset | alba |
-s, --speed | Speech speed (0.5-2.0) | 1.0 |
--voice-file | Custom WAV for cloning | None |
--serve | Start HTTP server | False |
--list-voices | List all voices | False |
Requirements
- Python 3.10-3.14
- PyTorch 2.5+ (CPU version works)
- Works on 2 CPU cores
Notes
- ⚠️ Model is gated - accept license on Hugging Face first
- 🌍 English language only (v1)
- 💾 First run downloads model (~100M parameters)
- 🔊 Audio is returned as 1D torch tensor (PCM data)