docs.md

Home Assistant add-on that uses wyoming-piper for text-to-speech system using the wyoming protocol on NVIDIA Jetson devices. Thank you to @ms1design for contributing these Home Assistant & Wyoming containers!

Features

• Works well with home-assistant-core container on Jetson devices as well as Home Assistant hosted on different hosts
• GPU accelerated on Jetson devices thanks to piper-tts container

Requires Home Assistant 2023.9 or later.

docker-compose example

If you want to use docker compose to run Home Assistant Core Voice Assistant Pipeline on a Jetson device with cuda enabled, you can find a full example docker-compose.yaml here.

name: home-assistant-jetson
version: "3.9"
services:
  homeassistant:
    image: dustynv/homeassistant-core:latest-r36.2.0
    restart: unless-stopped
    init: false
    privileged: true
    network_mode: host
    container_name: homeassistant
    hostname: homeassistant
    ports:
      - "8123:8123"
    volumes:
      - ha-config:/config
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro

  piper-tts:
    image: dustynv/wyoming-piper:master-r36.2.0
    restart: unless-stopped
    network_mode: host
    container_name: piper-tts
    hostname: piper-tts
    runtime: nvidia
    init: false
    ports:
      - "10200:10200/tcp"
    devices:
      - /dev/snd:/dev/snd
      - /dev/bus/usb
    volumes:
      - ha-piper-tts-models:/data/models/piper
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro

volumes:
  ha-config:
  ha-piper-tts-models:

Environment variables

Variable	Type	Default	Description
PIPER_PORT	str	10200	Port number to use on host
PIPER_CACHE	str	/data/models/piper	Name of a default mounted location available for downloading the models
PIPER_UPDATE_VOICES	bool	true	Download latest voices.json during startup
PIPER_LENGTH_SCALE	float	1.0	Phoneme length
PIPER_NOISE_SCALE	float	0.667	Generator noise
PIPER_NOISE_W	float	0.333	Phoneme width noise
PIPER_SPEAKER	[str, int]	0	Name or id of speaker for default voice
PIPER_VOICE	str	en_US-lessac-high	Default Piper voice to use (e.g., en_US-lessac-medium) from list of available voices
PIPER_MAX_PROC	int	1	Maximum number of piper process to run simultaneously
PIPER_DEBUG	bool	true	Log DEBUG messages

Configuration

Read more how to configure wyoming-piper in the official documentation:

Available Voices

List of available voices to download is available here.

TODO's

• Testing

Support

Got questions? You have several options to get them answered:

For general Home Assistant Support:

• The Home Assistant Discord Chat Server.
• The Home Assistant Community Forum.
• Join the Reddit subreddit in /r/homeassistant
• In case you've found an bug in Home Assistant, please open an issue on our GitHub.

For NVIDIA Jetson based Home Assistant Support:

• The NVIDIA Jetson AI Lab tutorials section.
• The Jetson AI Lab - Home Assistant Integration thread on NVIDIA's Developers Forum.
• In case you've found an bug in jetson-containers, please open an issue on our GitHub.

Note

This project was created by Jetson AI Lab Research Group.