pythonPorcupine - Python Quick Start

  • End-to-End Voice Platform
  • Offline Voice Recognition
  • Local Speech Recognition
  • Speech-to-Intent
  • Domain-Specific NLU
  • Wake Word Detection
  • Raspberry Pi
  • BeagleBone
  • NVIDIA Jetson
  • Linux
  • macOS
  • Windows
  • Python


  • Python 3
  • PIP


  • Linux (x86_64)
  • macOS (x86_64)
  • Windows (x86_64)
  • Raspberry Pi (all variants)
  • NVIDIA Jetson (Nano)
  • BeagleBone.


Install PyAudio and then the demo package

sudo pip3 install pvporcupinedemo

With a working microphone connected to your device run the following in the terminal

porcupine_demo_mic --keywords porcupine

The engine starts processing the audio input from the microphone in realtime and outputs to the terminal when it detects utterances of wake-word "porcupine".

Listening {
porcupine (0.50)
[2020-11-12 20:20:07.163542] Detected porcupine
[2020-11-12 20:20:08.964812] Detected porcupine
[2020-11-12 20:20:10.683725] Detected porcupine

Custom Wake Word

You can create custom Porcupine wake word models using Picovoice Console.

Issue with this doc? Please let us know.