KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

PorcupinePipeline

★ 30 Open GitHub ↗

Use Porcupine wake word to trigger a voice assistant pipeline in Home-Assistant

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# PorcupinePipeline

Use a raspberry pi and microphone to trigger a wake word
for a conversation with a Home-Assistant Voice Assistant

<https://www.home-assistant.io/voice_control/>

## Usage and Example

Required Authentication

- From Picovoice access_key for Porcupine wake word detection
        (Please note that your Picovoice user is only allowed one unique device.
        Running the docker image can result in a new device 
        that will prevent you from using Picovoice
        See: https://github.com/Picovoice/porcupine/issues/1020)

- From Home-Assistant long-lived access token

Environment Variables:

SERVER              Home-Assistant FQDN
    SERVER_PORT         Home-Assistant port
    SERVER_HTTPS        Home-Assistant using https
    TOKEN               Home-Assistant long-lived access token
    PIPELINE            Home-Assistant voice pipeline name

ACCESS_KEY          Picovoice access_key
    KEYWORDS            Wake words to trigger voice pipeline
    KEYWORD_PATHS       Absolute paths to keyword model files
    LIBRARY_PATH        Absolute path to dynamic library
    MODEL_PATH          Absolute path to the file containing model parameters

AUDIO_DEVICE        Index of audio device for microphone
    AUDIO_RATE          Rate of input audio
    AUDIO_WIDTH         Width of input audio sample
    AUDIO_CHANNELS      Number of input audio channels
    OUTPUT_PATH         Absolute path to recorded audio

Run:

cd /usr/src
    git clone https://github.com/slackr31337/PorcupinePipeline.git

export ACCESS_KEY='my-picovoice-access-key'
    export TOKEN='my-home-assistant-token'
    export SERVER=home-assistant.local
    export PIPELINE=OpenAI
    export AUDIO_DEVICE=1

python3 ./voice_pipeline.py --server home-assistant.local --pipeline 'OpenAI' --follow-up

Tested with:

wyoming-piper <https://hub.docker.com/r/rhasspy/wyoming-piper>
    wyoming-whisper <https://hub.docker.com/r/rhasspy/wyoming-whisper>
    Home-Assistant 2023.06.1 to 2023.08.2 <https://www.home-assistant.io/>

## Used code from the following projects

- https://github.com/synesthesiam/homeassistant-pipeline/blob/master/audio_to_audio.py

- https://github.com/Picovoice/porcupine/blob/master/demo/python/porcupine_demo_mic.py

https://github.com/Picovoice/porcupine
    AccessKey obtained from Picovoice Console (https://console.picovoice.ai/)

https://picovoice.ai/platform/porcupine/
    https://picovoice.ai/docs/porcupine/

PorcupinePipeline

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README