Palash DebnathandClaude Fable 5
030d5ea01f
* docs(engines): a guide for every engine + index; fix two engine-metadata bugs 21 new pages under docs/engines/ (10 TTS, 10 ASR, index README) — every registered engine now has one: what it's for, platform support, model env vars, quirks with issue refs. Linked from both READMEs' engine sections. Code fixes found while verifying facts against the registries: - KittenTTS docstring claimed default voice 'Jasper'; the code default is expr-voice-2-f - the isolated-ASR sidecar read only ASR_MODEL_FW while the download preflight read ASR_MODEL_FASTER — set one and the other quietly used a different model; both now resolve ASR_MODEL_FW-override → ASR_MODEL_FASTER - moonshine's install hint named 'useful-moonshine', a package the backend never imports; now moonshine-onnx / moonshine-voice Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(changelog): entries for the engine guides + sidecar model fix (#1556) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(engines): second-harvest fixes — TLS guidance, matrix/code alignment, CN counts - README matrix aligned to gpu_compat (the code is the source of truth): CosyVoice macOS is CPU not MPS, IndexTTS and GGUF gain their real CUDA/CPU/MPS cells - gpt-sovits guide: prefer https/tunnel for non-loopback servers, plaintext warning; first-use download guidance on both OmniVoice pages - preflight empty-env fallback matches the sidecar (ASR_MODEL_FASTER='' no longer resolves a different repo) - nano installs via uv pip; kitten log level wording; index links install guides incl. the Gatekeeper step; README_CN engine counts 16/11 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(readme-cn): the all-engines-local claim now excludes the remote client Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2.8 KiB
VoiceStudio — MOSS-TTS-Nano Engine
MOSS-TTS-Nano (OpenMOSS) is the low-resource, broad-language pick: a 100M-parameter autoregressive codec LM that runs realtime on a 4-core CPU — no GPU required — with native 48 kHz output and 20 languages under an Apache-2.0 license. It fills the "runs on a fanless laptop" tier while still covering languages like Arabic, Hebrew, Persian, Korean, and Turkish.
When to pick it
- CPU-only or low-power hardware, but you still need cloning and non-English coverage.
- Your language is among: Chinese, English, German, Spanish, French, Japanese, Italian, Hebrew, Korean, Russian, Persian, Arabic, Polish, Portuguese, Czech, Danish, Swedish, Hungarian, Greek, Turkish.
Setup
The package is not on PyPI — install it from the upstream repo into VoiceStudio's Python environment:
git clone https://github.com/OpenMOSS/MOSS-TTS-Nano.git
cd MOSS-TTS-Nano
uv pip install -e .
Then select the engine via Model Catalogue → Engines or
OMNIVOICE_TTS_BACKEND=moss-tts-nano.
Model selection
| Variable | Default | Meaning |
|---|---|---|
OMNIVOICE_MOSS_TTS_MODEL |
OpenMOSS-Team/MOSS-TTS-Nano |
HuggingFace checkpoint to load |
The first use downloads the weights (retried once on a truncated download). See downloading-models.md.
Behaviour notes
- Cloning is reference-only: pass a reference clip. Style instructions, preset speakers, and speed control are not supported and are silently ignored, so mixed-engine call sites keep working.
- The model emits 48 kHz stereo; VoiceStudio downmixes to mono, matching the rest of the pipeline (the dub mixer treats TTS output as mono per segment).
- Runs on CPU or CUDA.
Upstream is unpinned
The upstream repo is installed straight from git with no pinned release, and
the model class it exports has changed before
(#1287). VoiceStudio
therefore verifies that a usable model class actually exists — not just that
the package imports — before reporting the engine as ready. If the engine
shows unavailable with a "does not expose a usable model class" message,
pull the latest upstream and re-run uv pip install -e ., or open an issue
with the version you have.
Known limits
- No voice design, no instruct, no speed control — cloning from a reference clip only.
- Quality sits below the large engines; see benchmarks.md.
Troubleshooting
- "moss_tts_nano package not installed": run the clone +
uv pip install -e .steps above. - Entry-point errors after an upstream update: see "Upstream is unpinned" above.
- General issues: install/troubleshooting.md.
See also: languages.md, expressive-speech.md, disk usage.