# Piper

Piper is a fast, local neural text-to-speech system, and this container runs the Wyoming protocol server so Home Assistant voice assistants can generate audio locally on Raspberry Pi 4 and similar hardware. It is open source and self-hosted, installable on ZimaOS, Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1112/piper

## Description

Piper is a fast, local neural text-to-speech system, and this container runs the Wyoming protocol server so Home Assistant voice assistants can generate audio locally on Raspberry Pi 4 and similar hardware.

## Platform availability

Available on 2 of 9 platforms: Unraid, ZimaOS.

## Health score

65/100 (Good), based on 3 of 4 factors.
- Maintained: 87 (last commit 40 days ago)
- Popular: 47 (215 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)

## Links

- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/piper
- Docker Hub: https://hub.docker.com/r/linuxserver/piper
- GitHub: https://github.com/linuxserver/docker-piper
- Unraid: https://ca.unraid.net/apps/piper-0h9ngsa1n4k0p2?q=piper

## Common questions

### What port should the Wyoming Piper server use for Home Assistant?

The Home Assistant example listens on port 10200.

### Which directories do the run examples use for Piper data and downloads?

The examples pass --data-dir and --download-dir, such as /data.

### Why might a voice be missing from the advertised Piper voices?

Voices that require an uninstalled phonemizer are not advertised. The voice reappears once the required extra is installed.

### How do I enable the experimental OmniVoice backend?

Install the OmniVoice dependencies, select --backend omnivoice, and point --omnivoice-ref-dir at a directory organized by language and voice.

---
Source: Our Local Host (https://ourlocalhost.com/app/1112/piper), the self-hosted and open-source app directory.