Piper CLI
Piper — CLI для локальной озвучки текста: выбирайте голос, сохраняйте WAV и подключайте синтез к своим приложениям.
- 6 183 ★ репозитория
- Последний коммит
- GPL-3.0
Расширенный доступ
Почему такой уровень
- CLI скачивает модели и создает аудиофайлы, а режим воспроизведения выводит звук на устройстве.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/piperОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI скачивает модели и создает аудиофайлы, а режим воспроизведения выводит звук на устройстве.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Piper — CLI для превращения текста в речь на своем компьютере. Пользователь скачивает голосовую модель, передает текст и получает аудиофайл или воспроизведение через ffplay. Встроенный espeak-ng подготавливает произношение слов для синтеза. Проект OHF-Voice продолжает разработку прежнего Piper из rhasspy: старый репозиторий прямо ссылается на новый. Один голос состоит из модели ONNX и файла настроек. Для повторяющихся запросов автор рекомендует HTTP-сервер, который избавляет от загрузки модели при каждом вызове CLI.
Для кого. Разработчикам голосовых интерфейсов и авторам учебных записей, которым нужна локальная озвучка подготовленного текста.
Подходит, если
- Автор превращает короткий текст инструкции в WAV без облачного TTS.
- Разработчик подбирает голос для локального помощника.
- В учебном проекте надо воспроизводить текст на русском или другом поддерживаемом языке.
- Команда переносит частые запросы синтеза из отдельных CLI-вызовов в HTTP-сервер.
Не подходит, если
- Редактор хочет клонировать голос человека из предоставленной записи.
- Пользователь загружает только ONNX-файл без соответствующей конфигурации голоса.
- Коммерческий проект планирует использовать голос, не проверив его отдельную лицензию.
Пример запроса к агенту
Озвучь короткую инструкцию Piper в WAV, сначала покажи выбранный голос и ссылку на его MODEL_CARD.Ограничения
Для каждого голоса нужны два файла: `.onnx` и соответствующий `.onnx.json`. У голосовых моделей могут быть собственные ограничения лицензии, которые автор просит читать в `MODEL_CARD`. Отдельный CLI-вызов заново загружает модель, поэтому при постоянном синтезе автор советует HTTP-сервер. Ускорение `--cuda` требует пакета `onnxruntime-gpu`; его устанавливают отдельно перед запуском синтеза на поддерживаемом GPU.
Как отключить. Остановите процесс Piper или его HTTP-сервер и отключите вызовы из приложения. Голосовые модели и созданные WAV останутся файлами на диске.
Частые вопросы
Как установить текущий Piper?
Установите `pip install piper-tts`, затем скачайте голос и создайте тестовый WAV. Это текущий пакет OHF-Voice: старый репозиторий rhasspy/piper указывает на продолжение разработки здесь.
Как найти и скачать голос?
`python3 -m piper.download_voices` перечисляет голоса. Пример скачивания: `python3 -m piper.download_voices en_US-lessac-medium`; результат появится в текущей папке.
Как получить первый WAV?
После скачивания примера выполните `python3 -m piper -m en_US-lessac-medium -f test.wav -- 'This is a test.'`. Команда создаст `test.wav` с этой фразой.
Можно ли озвучивать по-русски?
Да, в списке Voices есть `ru_RU`. Выберите конкретный голос из загрузчика и прочитайте его `MODEL_CARD` до использования в своем проекте.
Как задать папку голосов?
Для загрузчика и синтеза предусмотрен `--data-dir <DIR>`. Подставьте свой каталог и используйте его в обоих местах, чтобы CLI нашел скачанные файлы.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыWhisper — CLI для расшифровки аудио: выбирайте размер модели под компьютер и получайте текст речи на исходном языке.
Локальный синтез речи для агентов: команда и скилл озвучивают текст, клонируют голос по записи и собирают музыку из партитуры без облака и платы за символы
MCP-сервер озвучки: превращает текст и сценарии с несколькими голосами в аудио через ElevenLabs и хранит историю заданий.
whisper.cpp — CLI для аудио без Python-окружения: разработчик собирает исполняемый файл под процессор или ускоритель.
Локальный MCP-сервер озвучки для macOS: клонирование голоса, синтез речи и аудиокниги из PDF по команде агента
Скилл с двумя скриптами: текст в голосовое сообщение .ogg и голосовое в текст через Яндекс SpeechKit, с десятью голосами и тремя эмоциями
Коротко о README
README ссылается на CLI, HTTP-сервер и программные API. Руководство голосов перечисляет языки и файлы моделей. Бинарные релизы прежнего проекта отделены от текущей установки через pip.