Instructions to use EryriLabs/pocket-tts-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Pocket-TTS
How to use EryriLabs/pocket-tts-GGUF with Pocket-TTS:
from pocket_tts import TTSModel import scipy.io.wavfile tts_model = TTSModel.load_model("EryriLabs/pocket-tts-GGUF") voice_state = tts_model.get_state_for_audio_prompt( "hf://kyutai/tts-voices/alba-mackenna/casual.wav" ) audio = tts_model.generate_audio(voice_state, "Hello world, this is a test.") # Audio is a 1D torch tensor containing PCM data. scipy.io.wavfile.write("output.wav", tts_model.sample_rate, audio.numpy()) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use EryriLabs/pocket-tts-GGUF with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf EryriLabs/pocket-tts-GGUF # Run inference directly in the terminal: llama cli -hf EryriLabs/pocket-tts-GGUF
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf EryriLabs/pocket-tts-GGUF # Run inference directly in the terminal: llama cli -hf EryriLabs/pocket-tts-GGUF
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf EryriLabs/pocket-tts-GGUF # Run inference directly in the terminal: ./llama-cli -hf EryriLabs/pocket-tts-GGUF
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf EryriLabs/pocket-tts-GGUF # Run inference directly in the terminal: ./build/bin/llama-cli -hf EryriLabs/pocket-tts-GGUF
Use Docker
docker model run hf.co/EryriLabs/pocket-tts-GGUF
- LM Studio
- Jan
- Ollama
How to use EryriLabs/pocket-tts-GGUF with Ollama:
ollama run hf.co/EryriLabs/pocket-tts-GGUF
- Unsloth Desktop
- Docker Model Runner
How to use EryriLabs/pocket-tts-GGUF with Docker Model Runner:
docker model run hf.co/EryriLabs/pocket-tts-GGUF
- Lemonade
How to use EryriLabs/pocket-tts-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull EryriLabs/pocket-tts-GGUF
Run and chat with the model
lemonade run user.pocket-tts-GGUF-{{QUANT_TAG}}List all available models
lemonade list
- Atomic Chat
Pocket TTS β GGUF (all languages)
GGUF conversions of Kyutai's Pocket TTS, for use with llama.cpp. Pocket TTS has been ported to ONNX, CoreML and MLX, and other GGUF conversions exist β but they ship without the multimodal projector. To our knowledge these are the first complete model + mmproj pairs that run directly on llama.cpp's built-in Pocket TTS support (llama-tts).
Pocket TTS is a 100M-parameter (24-layer French: ~300M) text-to-speech model designed by Kyutai to run efficiently on CPUs. On a desktop CPU these GGUFs synthesize at **5.5β6x realtime** (French ~2.9x) β no GPU needed.
Languages
Pocket TTS ships one complete model per language. Each is converted to a
llama.cpp GGUF pair: a model file and an mmproj file (the Mimi codec and
speaker encoder). Pass both to llama-tts. The mmproj files are per-language β
same size, different weights β so keep each pair together.
| Language | Files | Model size | Tested voice |
|---|---|---|---|
| English | pocket-tts-en.gguf + mmproj-pocket-tts-en.gguf (repo root) |
152 MB | unmute-prod-website/default_voice.wav |
| French | french/pocket-tts-french.gguf + french/mmproj-pocket-tts-french.gguf |
584 MB | cml-tts/fr/10087_11650_000028-0002_enhanced.wav |
| German | german/pocket-tts-german.gguf + german/mmproj-pocket-tts-german.gguf |
152 MB | unmute-prod-website/default_voice.wav |
| Italian | italian/pocket-tts-italian.gguf + italian/mmproj-pocket-tts-italian.gguf |
152 MB | unmute-prod-website/default_voice.wav |
| Portuguese | portuguese/pocket-tts-portuguese.gguf + portuguese/mmproj-pocket-tts-portuguese.gguf |
152 MB | unmute-prod-website/default_voice.wav |
| Spanish | spanish/pocket-tts-spanish.gguf + spanish/mmproj-pocket-tts-spanish.gguf |
152 MB | unmute-prod-website/default_voice.wav |
French is converted from upstream's french_24l checkpoint β the only French
variant Kyutai publishes. It has 24 transformer layers instead of 16, hence the
larger file and the lower real-time factor.
All six pairs were verified on CPU by synthesizing a native-language sentence and checking the output is valid, non-silent audio.
Usage
Requires official ggml-org/llama.cpp at or after commit 9f0d017 β Pocket TTS support is merged upstream, so a stock build of llama-tts works; no fork or patch needed. A speaker reference file is effectively mandatory β the model produces almost no audio without one.
llama-tts -m pocket-tts-en.gguf -mm mmproj-pocket-tts-en.gguf \
-p "Hello, this is Pocket TTS running locally." \
--tts-speaker-file default_voice.wav --output out.wav
Output is 24 kHz mono WAV at ~12.5 frames/sec.
Voices: reference clips only supply timbre; the language is fixed by the
weights. An English reference clip drives every language correctly, so you do
not need a native-language sample. Voices come from
kyutai/tts-voices, which currently
carries a dedicated non-English set for French only (cml-tts/fr).
Spanish note: avoid starting prompts with a leading Β‘ β it can truncate
generation after a fraction of a second. Begin with the word itself.
For a warm, OpenAI-compatible HTTP server (POST /v1/audio/speech) and a full local voice-assistant chain (Gemma 4 audio-in β Pocket TTS out, ~1.3s to first audio), see llama-tts-server and its Jetson edition jetson-voice-assistant.
Provenance
Converted with llama.cpp's convert_hf_to_gguf.py at master commit 9f0d017, from kyutai/pocket-tts languages/<name> (base checkpoints; French from french_24l), F16/F32 tensors as emitted by the converter (no quantization).
License and attribution
CC-BY-4.0, same as the upstream model. Original model by Kyutai (kyutai/pocket-tts, paper). This repo only repackages the weights in GGUF format.
- Downloads last month
- -
We're not able to determine the quantization variants.
Model tree for EryriLabs/pocket-tts-GGUF
Base model
kyutai/pocket-tts