leemysw/yovoice

★ 1,967⑂ 147

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.

About leemysw/yovoice

leemysw/yovoice is an open-source project on GitHub, mainly written in TypeScript. 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. It currently holds 1,967 stars and 147 forks with 9 open issues, and was last pushed on 2026-10-28 (repository created 2026-09-15).

Project Overview

Git Homed tracks it on the Audio Trending board and on the AI Audio Trending list.

GitHub Repository Details

Repository leemysw/yovoice · default branch main · size 21497 KB · watchers 4 · source: GitHub REST API and repository README

README

https://github.com/leemysw/yovoice/blob/HEAD/yovoice

yovoice

Give your words a voice. Compose your ideas into songs.

https://github.com/leemysw/yovoice/blob/HEAD/Website https://github.com/leemysw/yovoice/blob/HEAD/Latest release https://github.com/leemysw/yovoice/blob/HEAD/Downloads https://github.com/leemysw/yovoice/blob/HEAD/Build status https://github.com/leemysw/yovoice/blob/HEAD/License: Apache-2.0 https://github.com/leemysw/yovoice/blob/HEAD/Glama MCP server score https://github.com/leemysw/yovoice/blob/HEAD/Listed on mcpservers.org https://github.com/leemysw/yovoice/blob/HEAD/macOS 14+ (Apple Silicon) https://github.com/leemysw/yovoice/blob/HEAD/Windows 10/11 (x64) https://github.com/leemysw/yovoice/blob/HEAD/Linux (x64)

https://github.com/leemysw/yovoice/blob/HEAD/yovoice - Local-first voice, music, and score creation studio | Product Hunt

https://github.com/leemysw/yovoice/blob/HEAD/Listed on MacPip

https://github.com/leemysw/yovoice/blob/HEAD/Star History Rank https://github.com/leemysw/yovoice/blob/HEAD/leemysw%2Fyovoice | Trendshift

English · 简体中文

Website · CLI & Agent Skill · API / MCP Deployment · Development

---

yovoice is an open-source, local-first audio and music creation studio for macOS, Windows and Linux.

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.

yovoice creation workspace — browser preview

---

Why yovoice?

---

Features

---

Supported Models

| Use | Models | | --- | --- | | Voice cloning and emotion | IndexTTS 2.0 / 2.5, Qwen3-TTS Base | | Voice design and cloning | VoxCPM2, OmniVoice, Qwen3-TTS VoiceDesign, Breeze TTS 2, Ming 3.0 TTS | | More voice cloning | XTTS v2 (17 languages), Plapre 3 (Danish), Fish Audio Drama 3 (speaker and event tags) | | Built-in voices | Kokoro-82M, Qwen3-TTS CustomVoice, Voxtral 4B TTS, Gradium Phonon | | Songs and instrumentals | ACE-Step 1.5 Turbo / XL Turbo, YuE2 3B | | Instrumentals and sound effects | Stable Audio 3 Small Music / Small SFX / Medium | | Speech recognition and subtitles | Qwen3 ASR 0.6B / 1.7B, Confucius4-R2T2, Parakeet TDT 0.6B v3 | | Stems, MIDI and lyric alignment | HTDemucs 6-stem, BS-RoFormer, MuScriptor, Lyric Aligner, SheetSage2 |

All models are downloaded inside the App or with the CLI. See model selection 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.

---

Installation

Choose the package for your platform from the repository’s Releases tab or visit the official website.

| 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 | | Linux · x64 (Debian/Ubuntu) | -linux-x64.deb | sudo apt install ./yovoice--linux-x64.deb, then open yovoice from the application menu | | Linux · x64 (other distributions) | -linux-x64.tar.gz | Extract and run ./install.sh to add yovoice to the application menu for the current user |

The Windows installer downloads and installs WebView2 Runtime if needed. Models are downloaded inside the app; uninstalling preserves user data in ~/.yovoice.

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.

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.

---

Quick Start

1. Set up a model. Download a model in Settings (e.g. Kokoro-82M for fast narration, or VoxCPM2 for cloning). 2. Create a project. Choose Story dubbing, Speech generation, Music, or Score. 3. Add content. Enter text, lyrics, or notes, then pick a character and adjust style. 4. Generate audio. Select Generate, then preview, compare takes, edit, and export.

---

CLI & Agent Skill

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.
> Write an acoustic pop song about the last train home with YuE2 and save it as song.wav.

The agent runs the standalone CLI for speech, songs, sound effects, transcription and stem separation 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.

https://github.com/leemysw/yovoice/blob/HEAD/yovoice MCP server on Glama

Development

make install
make app-run

See the development guide for prerequisites. It also covers browser preview, tests, and project structure. For how the processes and packages fit together, see Architecture.

---

Community

Scan the QR code with WeChat to join the yovoice user group. If the code has expired, open an issue and we will post a new one.

https://github.com/leemysw/yovoice/blob/HEAD/yovoice WeChat group QR code

---

Contributing

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.

---

Acknowledgements

---

Star History

https://github.com/leemysw/yovoice/blob/HEAD/Star History Chart

---

License

Apache-2.0. Dependencies retain their original licenses; IndexTTS models are covered separately by their model license.

GitHub Stars & Activity

1,967Stars
147Forks
9Open issues
TypeScriptLanguage

GitHub Popularity

GitHub stars1,967
Forks147
Open issues9
Primary languageTypeScript
LicenseApache-2.0
Stars gained today0
Created2026-09-15
Last pushed2026-10-28

Trending History

Trending statusnot on today's boards

Related GitHub Projects

1

TalAter / annyang

TypeScript★ 6,821⑂ 0
→
2

liuzhao1225 / YouDub-webui

TypeScript★ 5,861⑂ 0
→
3

rsxdalv / TTS-WebUI

TypeScript★ 3,314⑂ 0
→
4

pluja / anysub

TypeScript★ 3,107⑂ 0
→
5

timoncool / YuE2-Studio

TypeScript★ 2,287⑂ 0
→
6

react-native-voice / voice

TypeScript★ 2,161⑂ 0
→
7

huggingface / transformers

Python★ 169,134⑂ 0
→
8

debpalash / VoiceStudio

Python★ 112,289⑂ 0
→

More Trending Repositories