Skip to main content

Porcupine wake word engine demo for ReSpeaker 4-mic hat.

Project description

Porcupine ReSpeaker Demo

Made in Vancouver, Canada by Picovoice

This package contains a commandline demo for controlling ReSpeaker 4-mic microphone array LEDs using Porcupine.


Porcupine is a highly-accurate and lightweight wake word engine. It enables building always-listening voice-enabled applications. It is

  • using deep neural networks trained in real-world environments.
  • compact and computationally-efficient. It is perfect for IoT.
  • cross-platform. Raspberry Pi, BeagleBone, Android, iOS, Linux (x86_64), macOS (x86_64), Windows (x86_64), and web browsers are supported. Additionally, enterprise customers have access to the ARM Cortex-M SDK.
  • scalable. It can detect multiple always-listening voice commands with no added runtime footprint.
  • self-service. Developers can train custom wake word models using Picovoice Console.


Follow the instructions on Seeed Studio to install and set up the microphone array.

Then install the demo:

sudo pip3 install ppnrespeakerdemo


The Porcupine SDK requires a valid AccessKey at initialization. AccessKeys act as your credentials when using Porcupine SDKs. You can create your AccessKey for free. Make sure to keep your AccessKey secret.

To obtain your AccessKey:

  1. Login or Signup for a free account on the Picovoice Console.
  2. Once logged in, go to the AccessKey tab to create one or use an existing AccessKey.


Below are the colors associated with supported wake words for this demo:

  • #ffff33 Alexa
  • #ff8000 Bumblebee
  • #ffffff Computer
  • #ff0000 Hey Google
  • #800080 Hey Siri
  • #ff3399 Jarvis
  • #00ff00 Picovoice
  • #0000ff Porcupine
  • #000000 Terminator

Run the demo:

porcupine_respeaker_demo --access_key ${ACCESS_KEY}

Wait for the demo to initialize and print [Listening] in the terminal. Say:


The demo outputs:

detected 'Picovoice'

The lights are now set to green. Say:


The lights are set to yellow now. Say:


to turn off the lights.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ppnrespeakerdemo, version 2.0.0
Filename, size File type Python version Upload date Hashes
Filename, size ppnrespeakerdemo-2.0.0-py3-none-any.whl (12.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size ppnrespeakerdemo-2.0.0.tar.gz (13.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page