MOSS-TTS

August 10, 2026 ยท View on GitHub

MOSS-TTS in audio.cpp includes the larger Local Transformer model and the smaller Nano model. Both use a MOSS audio tokenizer under the model root and support text-only speech plus optional zero-shot voice cloning through the framework speaker-reference interface.

MOSS-TTS-Local

MOSS-TTS-Local is the larger local-transformer path.

FieldValue
Familymoss_tts_local
Model directorymodels/MOSS-TTS-Local-Transformer-v1.5
Required codec layoutaudio_tokenizer/ directory inside the model root
Tasktts, clon
Modesoffline
LanguagesModel auto-handles supported languages; --language can pass a language hint
Voice inputOptional reference WAV through --voice-ref; transcript through --reference-text when known
Built-in voicesNot exposed

Text-only speech:

audiocpp_cli --task tts --family moss_tts_local --model /path/to/MOSS-TTS-Local-Transformer-v1.5 --backend cuda --text "Hello from MOSS-TTS-Local." --out out.wav

Voice clone:

audiocpp_cli --task clon --family moss_tts_local --model /path/to/MOSS-TTS-Local-Transformer-v1.5 --backend cuda --text "Hello from MOSS-TTS-Local." --voice-ref /path/to/reference.wav --reference-text "Reference transcript when available." --out out.wav
OptionValuesDefaultMeaning
--voice-refWAV pathnot setReference speaker audio for cloning.
--reference-texttextempty stringTranscript for reference audio.
--languagelanguage hintautoOptional language hint for the prompt template.
--max-tokensinteger4096Maximum generated audio frames.
--do-sampletrue, falsetrueEnable stochastic audio-token sampling.
--temperaturefloat1.7Audio-token sampling temperature.
--top-pfloat0.8Audio-token nucleus sampling limit.
--top-kinteger25Audio-token top-k sampling limit.
--repetition-penaltyfloat1.0Audio-token repetition penalty.
--request-option text_temperature=<float>float1.0Text-gate sampling temperature.
--request-option text_top_p=<float>float1.0Text-gate nucleus sampling limit.
--request-option text_top_k=<n>integer50Text-gate top-k sampling limit.
--text-chunk-sizecharacters2048Framework long-form text chunk size.
--text-chunk-modedefault, tag_aware, japanese, endlinedefaultFramework long-form text chunking mode.
--session-option moss_tts_local.weight_type=auto|native|f32|f16|bf16|q8_0enumautoBackbone weight storage type.
--session-option moss_tts_local.reference_cache_slots=<n>integer slots1Prepared reference-voice cache slots; set 0 to disable reuse.

MOSS-TTS-Nano

MOSS-TTS-Nano is the smaller MOSS TTS path. It supports text-only continuation generation and voice cloning through the framework speaker-reference interface.

FieldValue
Familymoss_tts_nano
Model directorymodels/MOSS-TTS-Nano-100M
Required codec layoutaudio_tokenizer/ directory inside the model root
Tasktts, clon
Modesoffline
LanguagesModel auto-handles supported languages
Voice inputOptional reference WAV through --voice-ref
Built-in voicesNot exposed

Text-only continuation:

audiocpp_cli --task tts --family moss_tts_nano --model /path/to/MOSS-TTS-Nano-100M --backend cuda --text "Hello from MOSS-TTS-Nano." --out out.wav

Voice clone:

audiocpp_cli --task clon --family moss_tts_nano --model /path/to/MOSS-TTS-Nano-100M --backend cuda --text "Hello from MOSS-TTS-Nano." --voice-ref /path/to/reference.wav --reference-text "Reference transcript when available." --out out.wav
OptionValuesDefaultMeaning
--voice-refWAV pathnot setReference speaker audio for cloning. When omitted, Nano uses text-only continuation mode.
--reference-texttextempty stringTranscript for reference audio; valid only with --voice-ref.
--max-tokensinteger300Maximum generated audio frames per chunk.
--do-sampletrue, falsetrueEnable stochastic audio-token sampling.
--temperaturefloat1.7Audio-token sampling temperature.
--top-pfloat0.8Audio-token nucleus sampling limit.
--top-kinteger25Audio-token top-k sampling limit.
--repetition-penaltyfloat1.0Audio-token repetition penalty.
--request-option text_temperature=<float>float1.5Text-gate sampling temperature.
--request-option text_top_p=<float>float1.0Text-gate nucleus sampling limit.
--request-option text_top_k=<n>integer50Text-gate top-k sampling limit.
--text-chunk-sizecharacters256Framework long-form text chunk size.
--text-chunk-modedefault, tag_aware, japanese, endlinedefaultFramework long-form text chunking mode.
--session-option moss_tts_nano.weight_type=native|f32|f16|bf16|q8_0enumnativeGlobal and local-frame weight storage type.
--session-option moss_tts_nano.global_weight_type=native|f32|f16|bf16|q8_0enumnativeGlobal transformer weight storage type.
--session-option moss_tts_nano.local_frame_weight_type=native|f32|f16|bf16|q8_0enumnativeLocal frame decoder weight storage type.
--session-option moss_tts_nano.global_prefill_graph_arena_mb=<n>MB256Global prefill graph arena size.
--session-option moss_tts_nano.global_decode_graph_arena_mb=<n>MB128Global decode graph arena size.
--session-option moss_tts_nano.global_weight_context_mb=<n>MB512Global transformer weight context size.
--session-option moss_tts_nano.local_frame_graph_arena_mb=<n>MB64Local frame decoder graph arena size.
--session-option moss_tts_nano.local_frame_weight_context_mb=<n>MB128Local frame decoder weight context size.
--session-option moss_tts_nano.audio_tokenizer_encoder_graph_arena_mb=<n>MB64Audio tokenizer encoder graph arena size.
--session-option moss_tts_nano.audio_tokenizer_decoder_graph_arena_mb=<n>MB64Audio tokenizer decoder graph arena size.
--session-option moss_tts_nano.audio_tokenizer_weight_context_mb=<n>MB128Audio tokenizer weight context size.