The project's README from github.com/leemysw/yovoice. As one markdown file: README.md.
Give your words a voice.
English · 简体中文
CLI & Agent Skill · API / MCP Deployment · Development
yovoice is an open-source voice creation tool for macOS and Windows that turns text into natural, expressive speech locally. With voice cloning, emotion control, audio project management, and a choice of TTS models, it requires no cloud API calls and incurs no per-character charges, giving you more control over narration, voiceovers, and audio content creation at a lower cost.

| Model | Parameters | Model file size by precision | Core capabilities |
|---|---|---|---|
| IndexTTS 2.0 | — | Q8 · 3.63 GB F16 · 4.65 GB ORIG · 8.08 GB |
Chinese/English voice cloning, emotion control, reference performance |
| IndexTTS 2.5 | — | Q8 · 3.50 GB F16 · 4.55 GB ORIG · 7.89 GB |
Multilingual voice cloning, emotion control, pronunciation editing |
| VoxCPM2 | 2B | Q8 · 2.96 GB BF16 · 4.77 GB ORIG · 4.96 GB |
Text-guided voice design, voice cloning, transcript-assisted cloning |
| OmniVoice | 0.6B | Q8 · 1.35 GB BF16 · 1.64 GB F16 · 1.64 GB |
Attribute-based voice design, voice cloning, non-verbal sound tags |
| Qwen3-TTS Base | 0.6B | Q8 · 1.99 GB BF16 · 2.52 GB |
Reference voice cloning, optional transcript guidance, multilingual speech |
| Qwen3-TTS Base | 1.7B | Q8 · 2.70 GB BF16 · 4.20 GB ORIG · 4.54 GB |
Reference voice cloning, optional transcript guidance, multilingual speech |
| Qwen3-TTS CustomVoice | 1.7B | Q8 · 2.82 GB BF16 · 4.18 GB |
9 built-in voices, text-guided style and emotion |
| Qwen3-TTS VoiceDesign | 1.7B | Q8 · 2.82 GB BF16 · 4.18 GB |
Voice design from natural-language descriptions, no reference audio required |
| Kokoro-82M 1.0 Official | 82M | Q8 · 189.55 MB BF16 · 211.95 MB |
49 built-in voices, multilingual speech excluding Japanese |
| Kokoro-82M 1.0 | 82M | Q8 · 932.66 MB | 54 built-in voices, full multilingual resources including Japanese; import only |
| Kokoro-82M 1.1-zh | 82M | Q8 · 255.32 MB | 100 Chinese and 3 English voices; experimental, import only |
| ACE-Step 1.5 Turbo | — | BF16 · 10.09 GB | Songs and instrumentals from a style prompt and lyrics, 50+ vocal languages; requires engine v0.9.1 |
All models are available in the App and CLI. See model selection for input requirements and examples. OmniVoice weights use the CC-BY-NC license and are restricted to non-commercial use.
Choose the package for your platform from the repository’s Releases tab.
| Platform | Package | Install |
|---|---|---|
| macOS 14+ · Apple Silicon | .dmg |
Open the disk image and drag yovoice to Applications |
| Windows 10/11 · x64 | -setup.exe |
Run the installer, then open yovoice from the Start menu |
| Windows 10/11 · x64 · NVIDIA GPU | -cuda12.4-setup.exe |
Bundles the CUDA 12.4 runtime; works with older GPUs and drivers and uses the GPU from first launch |
| Windows 10/11 · x64 · NVIDIA GPU | -cuda13.3-setup.exe |
Bundles the CUDA 13.3 runtime; needs a newer driver, smaller download |
The Windows installer downloads and installs WebView2 Runtime if needed. Models are downloaded inside the app; uninstalling preserves user data in ~/.yovoice.
Check for updates from the app menu on macOS or Windows. Updates are also checked and downloaded in the background; restart to install when ready. Windows updates download only the app (-update.exe) and keep the installed runtime; when a release recommends a newer runtime you can upgrade it in Settings → Inference engine, and it is required only when the runtime is below the minimum version the app needs.

Give your agent the yovoice Skill link and ask it to install the Skill and set up the local CLI, engine, and model:
Install this Skill and set up yovoice for local speech generation: https://github.com/leemysw/yovoice/tree/main/skills/yovoice
Then describe what you want:
Read narration.txt using voice.wav as the reference voice, with a calm delivery, and save it as narration.wav.
The agent runs the standalone CLI without opening the desktop app. See the CLI guide for details.
Run yovoice serve to provide an authenticated HTTP API and MCP inference service for other machines. See the API / MCP deployment guide for deployment and client examples.
make install
make app-run
See the development guide for prerequisites. It also covers browser preview, tests, and project structure.
Bug reports, feature suggestions, and pull requests are welcome. Include your platform, model, and steps to reproduce when reporting a problem. Run make check before submitting code changes.
Apache-2.0. Dependencies retain their original licenses; IndexTTS models are covered separately by their model license.