Files
llama.cpp/tools/tts
Xuan-Son Nguyen 3574df84b7 mtmd: support tiny-voca (#32427)
* mtmd: support tiny-voca

* improve G2P
2026-11-18 00:04:15 +01:00
..
2026-11-16 20:22:23 +01:00
2026-11-18 00:04:15 +01:00

llama.cpp TTS

This is a tool to demonstrate audio generation capability in llama.cpp via libmtmd. It was added via PR #26254

Note: this tool used to serve as a demo for OuteTTS, but it was converted to a more model-agnostic tool.

Common usage

Simple usage:

llama-tts -hf ggml-org/Qwen3-TTS-12Hz-1.7B-Base-GGUF -p "Hello world" --output out.wav

Note: it's highly recommended to always provide a speaker reference voice (via --tts-speaker-file); otherwise, the model's performance may be degraded.

Common params:

  • Sampling params such as --top-k, --top-p, --temp, etc. --temp also sets the temperature of the audio frames for models that support it, without it they use the model default
  • -n <number_of_frames> limits the output length, e.g. -n 500 (default: the limit of the model, 512 frames for most models). Note that how many milliseconds each frame represents varies by model
  • --tts-speaker-text (optional) gives the transcript of --tts-speaker-file, some models put it in the prompt (e.g. Fish Audio S2 Pro)
  • Core inference params such as -ngl, -b, -ub, etc.

Supported models

See docs/multimodal/tts.md for the list of supported models, their params and GGUF conversion notes.