Porcupine Wake Word
React Quick Start
- Chrome & Chromium-based browsers
- Picovoice Account and AccessKey
- Node.js 14+
- React 17.0+
Picovoice Account & AccessKey
Signup or Login to Picovoice Console to get your
Make sure to keep your
Install the npm packages:
Put the model file in the project's public directory or generate a base64 model using the build in script:
porcupineModel object with either of the methods above:
usePorcupine Hook that detects the built-in keywords
The Hook will take care of microphone access and audio downsampling (
To start audio recording and processing:
To stop audio recording and processing:
Allocated resources are automatically freed on unmount, but can also be done explicitly:
Create custom keywords using the Picovoice Console.
Train and download a Porcupine keyword model (
.ppn) for the target platform
This model file can be used directly with
publicPath, but, if
base64 is preferable, convert the
.ppn file to a base64
Similar to the model file (
.pv), keyword files (
.ppn) are saved in IndexedDB to be used by Web Assembly.
publicPath must be set for each keyword to instantiate Porcupine.
If both are set, Porcupine will use the
label is required to identify the keyword once the detection occurs.
Then, initialize an instance of
In order to use Porcupine with other languages, you need to use the corresponding model file (
.pv) for the desired language. The model files for all
supported languages are available on the Picovoice GitHub repository.
For the Porcupine React SDK, there is a React demo project available on the Porcupine GitHub repository.
Clone the Porcupine repository from GitHub:
- Install dependencies and run:
- Open http://localhost:3000 to view it in the browser.
- @picovoice/porcupine-react on the npm registry
- @picovoice/porcupine-web on the npm registry
- @picovoice/web-voice-processor on the npm registry