Skip to content
Back to search

yovoice

Open-source local AI audio & music studio for macOS & Windows. TTS, voice cloning, songs with lyrics, and multi-track scores — 100% offline, zero API fees.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/leemysw/yovoice with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/leemysw/yovoice'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/leemysw--yovoice/badge.svg)](/listings/leemysw--yovoice)

HTML

<a href="/listings/leemysw--yovoice"><img src="/api/listings/leemysw--yovoice/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Choose the package for your platform from the repository’s [Releases](../../releases) tab or visit the [official website](https://yovoice.leemysw.com).

| 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](https://developer.microsoft.com/microsoft-edge/webview2/) 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.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 202 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="desktop/icon/voice-workbench-app-icon-v1.png" width="96" alt="yovoice" />
  3. </p>
  4. <h1 align="center">yovoice</h1>
  5. <p align="center">Give your words a voice. Compose your ideas into songs.</p>
  6. <p align="center">
  7. <a href="https://yovoice.leemysw.com"><img src="https://img.shields.io/badge/website-yovoice.leemysw.com-10b981?style=flat-square" alt="Website" /></a>
  8. <a href="https://github.com/leemysw/yovoice/releases/latest"><img src="https://img.shields.io/github/v/release/leemysw/yovoice?style=flat-square&label=release&color=blue" alt="Latest release" /></a>
  9. <a href="https://github.com/leemysw/yovoice/releases"><img src="https://img.shields.io/github/downloads/leemysw/yovoice/total?style=flat-square&color=8b5cf6" alt="Downloads" /></a>
  10. <a href="https://github.com/leemysw/yovoice/actions/workflows/check.yml"><img src="https://img.shields.io/github/actions/workflow/status/leemysw/yovoice/check.yml?branch=main&style=flat-square" alt="Build status" /></a>
  11. <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-orange?style=flat-square" alt="License: Apache-2.0" /></a>
  12. <a href="https://glama.ai/mcp/servers/leemysw/yovoice"><img src="https://glama.ai/mcp/servers/leemysw/yovoice/badges/score.svg" alt="Glama MCP server score" /></a>
  13. <a href="https://mcpservers.org/servers/leemysw/yovoice"><img src="https://mcpservers.org/badge.svg" alt="Listed on mcpservers.org" /></a>
  14. <img src="https://img.shields.io/badge/macOS-14%2B-black?style=flat-square" alt="macOS 14+ (Apple Silicon)" />
  15. <img src="https://img.shields.io/badge/Windows-10%2F11-0078D4?style=flat-square" alt="Windows 10/11 (x64)" />
  16. <img src="https://img.shields.io/badge/Linux-x64-FCC624?style=flat-square" alt="Linux (x64)" />
  17. </p>
  18. <p align="center">
  19. <a href="https://www.producthunt.com/products/yovoice?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-yovoice" target="_blank" rel="noopener noreferrer">
  20. <img alt="yovoice - Local-first voice, music, and score creation studio | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1293995&amp;theme=light&amp;t=1793070018670" />
  21. </a>
  22. </p>
  23. <p align="center">
  24. <a href="https://macpip.com/apps/yovoice?ref=badge">
  25. <picture>
  26. <source media="(prefers-color-scheme: dark)" srcset="https://macpip.com/badge/yovoice.svg?theme=dark" />
  27. <img src="https://macpip.com/badge/yovoice.svg" height="58" alt="Listed on MacPip" />
  28. </picture>
  29. </a>
  30. </p>
  31. <p align="center">
  32. <a href="https://www.star-history.com/leemysw/yovoice">
  33. <picture>
  34. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/badge?repo=leemysw/yovoice&type=rank&theme=dark" />
  35. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/badge?repo=leemysw/yovoice&type=rank" />
  36. <img alt="Star History Rank" src="https://api.star-history.com/badge?repo=leemysw/yovoice&type=rank" width="250" height="55" />
  37. </picture>
  38. </a>
  39. <a href="https://trendshift.io/repositories/239687?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-239687">
  40. <img src="https://trendshift.io/api/badge/trendshift/repositories/239687/daily?language=TypeScript" alt="leemysw%2Fyovoice | Trendshift" width="250" height="55"/>
  41. </a>
  42. </p>
  43. <p align="center">English · <a href="README_zh.md">简体中文</a></p>
  44. <p align="center"><a href="https://yovoice.leemysw.com">Website</a> · <a href="docs/cli.md">CLI & Agent Skill</a> · <a href="docs/api.md">API / MCP Deployment</a> · <a href="docs/development.md">Development</a></p>
  45. ---
  46. yovoice is an open-source, local-first audio and music creation studio for macOS, Windows and Linux.
  47. Turn text into expressive speech, natural cloned voices, complete vocal songs, and multi-track scores right on your machine. Featuring zero-shot voice cloning, emotional performance controls, AI music generation with lyrics, and General MIDI score arranging—**all running 100% locally with zero cloud API calls, zero per-character fees, and zero Python environment headaches.**
  48. ![yovoice creation workspace — browser preview](docs/images/yovoice-workspace.png)
  49. ---
  50. ## Why yovoice?
  51. - 🔒 **100% Local Privacy**: Runs entirely on your local GPU/CPU. Your manuscripts, reference voices, and creations never leave your computer.
  52. - 💸 **Zero Recurring Fees**: Say goodbye to per-character/per-minute meters and expensive cloud voice/music subscriptions.
  53. - ⚡ **Native C++ Performance (No Python Hell)**: Powered by [audio.cpp](https://github.com/0xShug0/audio.cpp) v0.9.3. Ships with bundled Windows CUDA 12.4/13.3 runtimes and native macOS Metal support. Double-click and create—no Conda or PyTorch conflicts.
  54. - 🎛️ **Creator Workstation**: Multi-take versioning for side-by-side comparison, waveform trimming, timeline scrolling, and clean stems/MIDI export.
  55. - 🤖 **MCP & AI Agent Ecosystem**: Chat with DeepSeek, Qwen, Claude, OpenAI, or local Ollama to create and edit works end to end. Includes a native Model Context Protocol (MCP) server for Cursor and Claude Code.
  56. ---
  57. ## Features
  58. - **Speech, voice design and cloning** — clone a reference voice, design a voice from a description, adjust emotion and delivery, and edit takes on a timeline.
  59. - **Story dubbing** — import text or subtitle files, assign a character to each line, and generate line by line.
  60. - **Transcribe and subtitles** — turn audio or video into timed subtitle lines and export SRT / WebVTT, fill in a reference transcript automatically, or export aligned subtitles for a speech version.
  61. - **Music** — write a style and lyrics with section markers, then generate songs or instrumentals with ACE-Step 1.5, or songs and score-based instrumentals with YuE2, or instrumental music and sound effects from an English description with Stable Audio 3; the playback page syncs lyrics to the vocals. Separate any song into six stems and mix them in the stem studio, or transcribe it to multi-instrument MIDI.
  62. - **Score** — write parts by bar and beat, import MIDI or let an Agent compose, render with a General MIDI sound font, and export MIDI and stems. See [Score](docs/score.md).
  63. - **Optional AI service** — the built-in assistant panel chats with DeepSeek, Qwen, Kimi, OpenAI, Anthropic, Ollama or any compatible API and acts on your works: it writes arrangements and lyrics, edits text, assigns voices and starts generation; keys stay on this computer. See [AI service](docs/ai.md).
  64. - **12 interface languages** — English, 简体中文, 繁體中文, 日本語, 한국어, Español, Français, Deutsch, Português (Brasil), Русский, Italiano and Tiếng Việt; switch anytime in Settings, no restart needed.
  65. ---
  66. ## Supported Models
  67. | Use | Models |
  68. | --- | --- |
  69. | Voice cloning and emotion | IndexTTS 2.0 / 2.5, Qwen3-TTS Base |
  70. | Voice design and cloning | VoxCPM2, OmniVoice, Qwen3-TTS VoiceDesign, Breeze TTS 2, Ming 3.0 TTS |
  71. | More voice cloning | XTTS v2 (17 languages), Plapre 3 (Danish), Fish Audio Drama 3 (speaker and event tags), Audio8 TTS Realistic (11 languages) |
  72. | Built-in voices | Kokoro-82M, Qwen3-TTS CustomVoice, Voxtral 4B TTS, Gradium Phonon |
  73. | Songs and instrumentals | ACE-Step 1.5 Turbo / XL Turbo, YuE2 3B |
  74. | Instrumentals and sound effects | Stable Audio 3 Small Music / Small SFX / Medium |
  75. | Speech recognition and subtitles | Qwen3 ASR 0.6B / 1.7B, Confucius4-R2T2, Parakeet TDT 0.6B v3 |
  76. | Stems, MIDI and lyric alignment | HTDemucs 6-stem, BS-RoFormer, MuScriptor, Lyric Aligner, SheetSage2 |
  77. All models are downloaded inside the App or with the CLI. See [model selection](docs/models.md) for file sizes, hardware requirements, inputs and examples. OmniVoice, YuE2, Breeze TTS 2, Voxtral 4B TTS and MuScriptor weights are restricted to non-commercial use; XTTS v2 and Drama 3 use their own Coqui and Fish Audio licenses; Stable Audio 3 is free below USD 1M annual revenue under the Stability AI Community License.
  78. ---
  79. ## Installation
  80. Choose the package for your platform from the repository’s [Releases](../../releases) tab or visit the [official website](https://yovoice.leemysw.com).
  81. | Platform | Package | Install |
  82. | --- | --- | --- |
  83. | macOS 14+ · Apple Silicon | `.dmg` | Open the disk image and drag yovoice to Applications |
  84. | Windows 10/11 · x64 | `-setup.exe` | Run the installer, then open yovoice from the Start menu |
  85. | 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 |
  86. | Windows 10/11 · x64 · NVIDIA GPU | `-cuda13.3-setup.exe` | Bundles the CUDA 13.3 runtime; needs a newer driver, smaller download |
  87. | Linux · x64 (Debian/Ubuntu) | `-linux-x64.deb` | `sudo apt install ./yovoice-<version>-linux-x64.deb`, then open yovoice from the application menu |
  88. | Linux · x64 (other distributions) | `-linux-x64.tar.gz` | Extract and run `./install.sh` to add yovoice to the application menu for the current user |
  89. The Windows installer downloads and installs [WebView2 Runtime](https://developer.microsoft.com/microsoft-edge/webview2/) if needed. Models are downloaded inside the app; uninstalling preserves user data in `~/.yovoice`.
  90. On Linux the app needs WebKitGTK 4.1 (`libwebkit2gtk-4.1-0` on Debian/Ubuntu, `webkit2gtk4.1` on Fedora, `webkit2gtk-4.1` on Arch); the `.deb` installs it automatically. Linux runs on the CPU out of the box, and a Vulkan GPU runtime can be downloaded in Settings → Inference engine. The Linux app doesn't update itself yet; download new versions from Releases.
  91. 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.
  92. ---
  93. ## Quick Start
  94. 1. **Set up a model.** Download a model in Settings (e.g. Kokoro-82M for fast narration, or VoxCPM2 for cloning).
  95. 2. **Create a project.** Choose Story dubbing, Speech generation, Music, or Score.
  96. 3. **Add content.** Enter text, lyrics, or notes, then pick a character and adjust style.
  97. 4. **Generate audio.** Select Generate, then preview, compare takes, edit, and export.
  98. ---
  99. ## CLI & Agent Skill
  100. Give your agent the [yovoice Skill](https://github.com/leemysw/yovoice/tree/main/skills/yovoice) link and ask it to install the Skill and set up the local CLI, engine, and model:
  101. > Install this Skill and set up yovoice for local speech generation: https://github.com/leemysw/yovoice/tree/main/skills/yovoice
  102. Then describe what you want:
  103. > Read narration.txt using voice.wav as the reference voice, with a calm delivery, and save it as narration.wav.
  104. >
  105. > Write an acoustic pop song about the last train home with YuE2 and save it as song.wav.
  106. The agent runs the standalone CLI for speech, songs, sound effects, transcription and stem separation without opening the desktop app. See the [CLI guide](docs/cli.md) for details.
  107. ---
  108. Run `yovoice serve` to provide an authenticated HTTP API and MCP inference service for other machines. See the [API / MCP deployment guide](docs/api.md) for deployment and client examples.
  109. <a href="https://glama.ai/mcp/servers/leemysw/yovoice"><img width="380" height="200" src="https://glama.ai/mcp/servers/leemysw/yovoice/badges/card.svg" alt="yovoice MCP server on Glama" /></a>
  110. ## Development
  111. ```sh
  112. make install
  113. make app-run
  114. ```
  115. See the [development guide](docs/development.md) for prerequisites. It also covers browser preview, tests, and project structure. For how the processes and packages fit together, see [Architecture](docs/architecture.md).
  116. ---
  117. ## Community
  118. Scan the QR code with WeChat to join the yovoice user group. If the code has expired, open an [issue](../../issues) and we will post a new one.
  119. <p align="center"><img src="docs/images/Group%20chat_%E3%80%90YOVOICE%E3%80%91%E4%BA%A4%E6%B5%81%E7%BE%A4.png" width="240" alt="yovoice WeChat group QR code" /></p>
  120. ---
  121. ## Contributing
  122. 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.
  123. ---
  124. ## Acknowledgements
  125. - [audio.cpp](https://github.com/0xShug0/audio.cpp) by ShugoAI — the local audio inference engine.
  126. - [VoxCPM](https://github.com/OpenBMB/VoxCPM) — voice design and cloning models, licensed under Apache-2.0.
  127. - [IndexTTS](https://github.com/index-tts/index-tts) — the speech synthesis models behind yovoice.
  128. - [OmniVoice](https://github.com/k2-fsa/OmniVoice) — voice design and cloning models.
  129. - [Qwen3-TTS](https://github.com/QwenLM/Qwen3-TTS) — voice cloning, built-in voices, and text-guided voice design.
  130. - [ACE-Step](https://github.com/ace-step/ACE-Step-1.5) — music generation from style prompts and lyrics.
  131. - [YuE](https://github.com/multimodal-art-projection/YuE) — full vocal song generation from lyrics.
  132. - [Stable Audio 3](https://huggingface.co/stabilityai/stable-audio-3-medium) by Stability AI — instrumental music and sound effects from text. Powered by Stability AI.
  133. - [Breeze TTS 2](https://huggingface.co/BreezeBlue/Breeze-TTS-2) — Chinese and English voice design and cloning.
  134. - [go-meltysynth](https://github.com/sinshu/go-meltysynth), [MuseScore General](https://musescore.org/en/handbook/3/soundfonts-and-sfz-files#gm_soundfonts), [GeneralUser GS](https://www.schristiancollins.com/generaluser) and SGM-V2.01 by David Shan — the SoundFont synthesizer and sound fonts behind score rendering.
  135. - Kokoro — lightweight speech synthesis with built-in voices: [Kokoro-82M](https://huggingface.co/hexgrad/Kokoro-82M) and [Kokoro-82M-v1.1-zh](https://huggingface.co/hexgrad/Kokoro-82M-v1.1-zh).
  136. ---
  137. ## Star History
  138. <a href="https://www.star-history.com/?repos=leemysw%2Fyovoice&type=date&legend=bottom-right">
  139. <picture>
  140. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=leemysw/yovoice&type=date&theme=dark&legend=bottom-right" />
  141. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=leemysw/yovoice&type=date&legend=bottom-right" />
  142. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=leemysw/yovoice&type=date&legend=bottom-right" />
  143. </picture>
  144. </a>
  145. ---
  146. ## License
  147. [Apache-2.0](LICENSE). Dependencies retain their [original licenses](THIRD_PARTY_NOTICES.md); IndexTTS models are covered separately by their [model license](web/public/model-license.txt).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.