Files
linux-voice-assistant/README.md
T
2026-02-01 20:20:46 +01:00

2.9 KiB

Linux-Voice-Assistant

CI GitHub Package Version GitHub License GitHub last commit GitHub Container Registry

Experimental Linux-Voice-Assistant for [Home Assistant][https://www.home-assistant.io/] that uses the [ESPHome][https://esphome.io/] protocol.

Features:

  • Works with Home Assistant
  • Local wake word detection using integrated OpenWakeWord or MicroWakeWord
  • Supports multiple architectures (linux/amd64 and linux/aarch64)
  • Automated builds with artifact attestation for security
  • Supports multiple wake words and languages
  • Supports announcments, start/continue conversation, and timers
  • Tested with Python 3.13 and Python 3.11.
  • Prebuild docker image available on GitHub Container Registry
  • Prebuild Raspberry Pi image

Usage:

Hardware:

You can for example use the Raspberry Pi Zero 2W with the Satellite1 Hat Board or the Respeaker 2Mic_Hat. A list for possible compatible hardware can be found in the PiCompose documentation but basically any microphone that works with Pipewire can be used.

Software:

See Linux-Voice-Assistant - Installation

Build Information:

Image builds can be tracked in this repository's Actions tab, and utilize artifact attestation to certify provenance.

The Docker images are built using GitHub Actions, which provides:

  • Automated builds for different architectures
  • Artifact attestation for build provenance verification
  • Regular updates and maintenance

The documentation for the build process can be found in the GitHub Actions Workflows file.