selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
wyoming-piper logo

Self-host wyoming-piper

v2.5.2

Wyoming protocol server for Piper text-to-speech

ReleaseOpen SourceMIT
Updated13 hours ago
LanguagePython
Setup difficultyModerate
Stars
218
CPU
desktop/server CPU (OmniVoice backend)
Ports
10200 (Wyoming protocol TCP server), 5000 (Voice management web UI), 10300 (Alternative Wyoming protocol port (example))
Requires
Python
Docker
rhasspy/wyoming-piper
Install with Docker

What is wyoming-piper?

Wyoming Piper is a Wyoming protocol server for the Piper text-to-speech system. It enables self-hosted neural TTS with support for dozens of voices across many languages. The server speaks the Wyoming protocol, making it compatible with Home Assistant's Piper integration and other Wyoming clients. It can run via Docker, as a local Python installation, or as a Home Assistant add-on. An experimental OmniVoice backend adds voice cloning and design capabilities. A web UI allows managing custom voices. The project requires Python 3.10 or later and runs on Linux, with GPU acceleration available via a separate Docker image.

Should you self-host wyoming-piper?

wyoming-piper scores 52/100 on selfhost.directory (how scoring works) and ranks #7 of 9 in Text to Speech. It has 218 GitHub stars.

It shipped 15 stable releases in the past year. The latest, v2.5.2, came out on 11 September 2026. New versions land roughly every 2 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is OmniVoice-Studio (94/100, 92 652 stars). It scores higher overall, so compare the two before you pick. See wyoming-piper vs OmniVoice-Studio side by side.

Features

  • Container health check
  • Dynamic Voice DiscoveryHome Assistant caches voice list; integration reload needed for new voices.
  • GPU AccelerationRequires NVIDIA driver and NVIDIA Container Toolkit; linux/amd64 only.
  • Home Assistant Integration
  • Multi-language Support
  • Offline Operation
  • OmniVoice Backend (Experimental)Experimental backend requiring desktop/server CPU and additional dependencies.
  • Piper TTS Backend
  • Voice Management Web UINo authentication; only enable on trusted networks.
  • Wyoming Protocol Support

wyoming-piper README

How to install wyoming-piper

Install wyoming-piper with Docker

Docker Engine
Environment variables
WYOMING_PIPER_ARGS for Docker Compose

docker run -it -p 10200:10200 -v /path/to/local/data:/data rhasspy/wyoming-piper --voice en_US-lessac-medium

Main image for Piper backend

How to configure wyoming-piper

  • --backendpiperTTS backend to use (piper or omnivoice)

    TTS backend to use (piper or omnivoice)

    values: piper, omnivoice

  • --data-dirDirectory for model data

    Directory for model data

    values: Any writable directory path

  • --download-dirDirectory for downloading voices

    Directory for downloading voices

    values: Any writable directory path

  • --local-files-onlyfalseRun fully offline using cached models

    Run fully offline using cached models

    values: true, false

  • --omnivoice-languageOmniVoice language code

    OmniVoice language code

    values: Any ISO 639-3 language code

  • --omnivoice-onnx-repoHuggingFace repo for OmniVoice ONNX model

    HuggingFace repo for OmniVoice ONNX model

    values: HuggingFace repository identifier

  • --omnivoice-ref-dirDirectory for OmniVoice reference voices

    Directory for OmniVoice reference voices

    values: Any writable directory path

  • --omnivoice-stepsOmniVoice inference steps (quality vs speed)

    OmniVoice inference steps (quality vs speed)

    values: Integer (e.g., 10, 32)

  • --uritcp://0.0.0.0:10200Wyoming server URI (tcp://host:port)

    Wyoming server URI (tcp://host:port)

    values: Any valid TCP URI

  • --use-cudaautoEnable CUDA acceleration (GPU image)

    Enable CUDA acceleration (GPU image)

    values: true, false

  • --voiceVoice to use for TTS (e.g., en_US-lessac-medium)

    Voice to use for TTS (e.g., en_US-lessac-medium)

    values: Any available Piper voice name

  • --web-serverfalseEnable voice management web UI

    Enable voice management web UI

    values: true, false

  • --web-server-allowAllowed IP/CIDR for web UI access

    Allowed IP/CIDR for web UI access

    values: IP address or CIDR range

  • --web-server-host127.0.0.1Web UI bind address

    Web UI bind address

    values: Any valid IP address

  • --web-server-port5000Web UI port

    Web UI port

    values: Any valid port number

  • WYOMING_PIPER_ARGSShell-style argument string for Docker Compose

    Shell-style argument string for Docker Compose

    values: Any valid command line arguments

wyoming-piper releases & version history

More in Text to Speech

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…