From 606375f8c3c6804bbe13883fcf5a09c66f0f6487 Mon Sep 17 00:00:00 2001
From: Xuan Son Nguyen <son@huggingface.co>
Date: Tue, 11 Aug 2026 00:56:18 +0200
Subject: [PATCH] add docs

---
 tools/tts/README.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/tools/tts/README.md b/tools/tts/README.md
index dd84336c39..1b08d5ef32 100644
--- a/tools/tts/README.md
+++ b/tools/tts/README.md
@@ -32,3 +32,28 @@ llama-tts -hf ggml-org/Qwen3-TTS-12Hz-1.7B-Base-GGUF \
     --tts-speaker-file speaker.mp3 \
     --output out.wav
 ```
+
+## Pocket TTS
+
+Available params:
+- `--tts-speaker-file` should point to a speaker reference audio file (wav, mp3). It is required, the model produces almost no audio without it
+- Note: `lang` is not used, the language is a property of the weights
+
+Example usage:
+
+```sh
+llama-tts -m pocket-tts.gguf \
+    -mm mmproj-pocket-tts.gguf \
+    -p "Hello world" \
+    --tts-speaker-file speaker.mp3 \
+    --output out.wav
+```
+
+**Note for GGUF conversion:**
+
+The [upstream repository](https://huggingface.co/kyutai/pocket-tts) holds one complete model per language under `languages/`, next to a set of shared files at the root. Convert one of the `languages/<name>` directories, **not** the root directory:
+
+```sh
+python convert_hf_to_gguf.py path/to/pocket-tts/languages/english --outfile pocket-tts.gguf
+python convert_hf_to_gguf.py path/to/pocket-tts/languages/english --mmproj --outfile mmproj-pocket-tts.gguf
+```