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>
1.8 KiB
1.8 KiB
VoiceStudio — Moonshine Engine
Moonshine is an edge-optimized ASR family built for CPU-only machines. Unlike Whisper it processes variable-length audio (no padding everything to 30 s), which keeps latency low on short clips — sub-200 ms class on capture buffers. It's the lightest local option for quick transcription on hardware where even int8 whisper-large is too slow.
Selecting it
- Install one of the runtimes into the app venv:
uv pip install moonshine-onnx(lighter, tried first) ormoonshine-voice. - Then Model Catalogue → Engines, ASR tab → Use on the Moonshine row,
or
OMNIVOICE_ASR_BACKEND=moonshine.
Auto-detect never picks it; it's an explicit opt-in.
Best at
- Quick notes and short-clip transcription on low-power CPU machines.
- Environments where a sub-1 GB footprint matters more than word timing or language coverage.
Not suited for
- Dubbing. Output is plain text as a single segment spanning the whole file — no word or segment timestamps — so there's nothing for lip-sync or subtitle timing to work with. Use a Whisper-family engine or sherpa-onnx-asr for those jobs.
- Multilingual work: results report English; for broad language coverage use whisperx or funasr.
Platform support
CPU only, by design — macOS, Windows, and Linux. It claims no GPU.
Model selection
ASR_MODEL_MOONSHINE — default moonshine/base. Weights download on first
load — see downloading-models.
Quirks
- The engine tries
moonshine_onnxfirst and falls back tomoonshine_voice— installing either one is enough. - Segment bounds are synthesized from the audio duration (start 0, end = file length), since the model reports none.