leemysw/yovoice

选用指南

AI 根据 README 整理 · 2026/10/19 18:21:18

适用场景

适用于需要本地语音合成、声音克隆、音乐生成和乐谱编排的创作者，支持故事配音、歌词歌曲生成和多轨乐谱编排。

查看 README 依据

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.**  --- ## Why yovoice?

- **Story dubbing** — import text or subtitle files, assign a character to each line, and generate line by line. - **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; the playback page syncs lyrics to the vocals. - **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).

使用方式

提供桌面应用、CLI 和 API/MCP 服务，可通过命令行或 HTTP API 进行推理。

查看 README 依据

> 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](docs/cli.md) for details. --- 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. ## Development ```sh make install make app-run ```

部署要求

需要 macOS 14+（Apple Silicon）或 Windows 10/11（x64），NVIDIA GPU 可选，模型在应用内下载。

查看 README 依据

<a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-orange?style=flat-square" alt="License: Apache-2.0" /></a> <img src="https://img.shields.io/badge/macOS-14%2B-black?style=flat-square" alt="macOS 14+ (Apple Silicon)" /> <img src="https://img.shields.io/badge/Windows-10%2F11-0078D4?style=flat-square" alt="Windows 10/11 (x64)" /> </p> <p align="center"> <a href="https://www.star-history.com/leemysw/yovoice"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/badge?repo=leemysw/yovoice&type=rank&theme=dark" />

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 |

已知限制

部分模型（如 OmniVoice、YuE2 和 Breeze TTS 2）权重仅限非商业使用。

查看 README 依据

| Voice cloning and emotion | IndexTTS 2.0 / 2.5, Qwen3-TTS Base | | Voice design and cloning | VoxCPM2, OmniVoice, Qwen3-TTS VoiceDesign, Breeze TTS 2 | | Built-in voices | Kokoro-82M, Qwen3-TTS CustomVoice | | Songs and instrumentals | ACE-Step 1.5 Turbo / XL Turbo, YuE2 3B | 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 and Breeze TTS 2 weights are restricted to non-commercial use. --- ## Installation