yovoice README

The project's README from github.com/leemysw/yovoice. As one markdown file: README.md.

yovoice

yovoice

Give your words a voice.

Version 0.1.7 License: Apache-2.0 macOS 14+ (Apple Silicon) Windows 10/11 (x64)

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.

yovoice creation workspace — browser preview


Features


Supported Models

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.


Installation

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.

Install yovoice on macOS


Quick Start

  1. Set up a model. Download a model in Settings.
  2. Create a project. Choose Story dubbing or Speech generation.
  3. Add content. Enter text or import subtitles, then choose a character and adjust the voice.
  4. Generate audio. Select Generate speech, then preview, 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.

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.

Development

make install
make app-run

See the development guide for prerequisites. It also covers browser preview, tests, and project structure.


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


License

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

yovoice (leemysw/yovoice)

Searching Database…

1.6K ·GitHub
Что это?yovoice — открытая настольная программа для macOS и Windows, которая локально превращает текст в естественную, выразительную речь, с клонированием голоса и управлением эмоциями, без облачных API-вызовов и платы за символ.
Это настольное приложение или облачный сервис?Это нативное настольное приложение, устанавливаемое из пакета .dmg (macOS) или .exe (Windows), плюс отдельный CLI и опциональный локальный режим «yovoice serve», открывающий HTTP/MCP API для других машин.
Как это запустить?Возьмите установщик для своей платформы на вкладке GitHub Releases (.dmg для macOS, -setup.exe для Windows), установите, затем скачайте модель в настройках, создайте проект «озвучка Story» или «генерация речи», добавьте текст или субтитры и сгенерируйте аудио.
Работает ли он на Mac с Intel или нужна конкретная сборка CUDA?Сборка для macOS нацелена только на macOS 14+ с Apple Silicon; в Windows нужны отдельные установщики в зависимости от возраста вашей GPU/драйвера NVIDIA (CUDA 12.4 для старых карт, CUDA 13.3 для новых драйверов, с меньшим объёмом загрузки).
Куда уходят мои данные и ключи ИИ?Генерация речи полностью выполняется на вашей машине; если подключить опциональный ИИ-сервис для аранжировок или текстов песен, ключи API остаются на этом компьютере.
Действительно ли всё это бесплатно, включая модели?Сам yovoice — под Apache-2.0, но веса модели OmniVoice — под CC-BY-NC и ограничены некоммерческим использованием, а модели IndexTTS имеют свою отдельную лицензию.
Что Agent Skill позволяет делать кодинг-агенту?Он позволяет ИИ-агенту установить Skill, настроить локальные CLI, движок инференса и модель, а затем генерировать озвучку из текста и референсного аудиофайла без открытия настольного приложения.
Может ли yovoice создавать целые песни, а не только речь?Да — вы описываете стиль и пишете текст с маркерами секций, а ACE-Step 1.5 генерирует полные песни или инструменталы, сохраняя каждый дубль как сравнимую версию.
Для чего нужна функция Score?Это нотный редактор с тактами и долями (или импорт MIDI, или партитуры, написанные агентом), который рендерится через саунд-фонт General MIDI в точно воспроизводимое аудио с экспортом в MIDI и отдельные дорожки (stems).
Что происходит с моими данными при удалении приложения?При удалении пользовательские данные в папке ~/.yovoice сохраняются, так что ваши проекты и настройки переживут переустановку.
Creator
leemysw
Size
17 MB
Stars
1.6K
Age
1mo
Commits · 90 Days