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-voices
Python 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)
Links
