# Porcupine Wake Word Engine
Made in Vancouver, Canada by [Picovoice](https://picovoice.ai)
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:
- Arm Cortex-M, STM32, Arduino, and i.MX RT
- Raspberry Pi, NVIDIA Jetson Nano, and BeagleBone
- Android and iOS
- Chrome, Safari, Firefox, and Edge
- Linux (x86_64), macOS (x86_64, arm64), and Windows (x86_64)
- 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](https://console.picovoice.ai/).
## Compatibility
- Python 3.5+
- Runs on Linux (x86_64), macOS (x86_64 and arm64), Windows (x86_64), Raspberry Pi, NVIDIA Jetson (Nano), and BeagleBone.
## Installation
```console
pip3 install pvporcupine
```
## AccessKey
Porcupine requires a valid Picovoice `AccessKey` at initialization. `AccessKey` acts as your credentials when using Porcupine SDKs.
You can get your `AccessKey` for free. Make sure to keep your `AccessKey` secret.
Signup or Login to [Picovoice Console](https://console.picovoice.ai/) to get your `AccessKey`.
## Usage
Create an instance of the engine
```python
import pvporcupine
access_key = "${ACCESS_KEY}" # AccessKey obtained from Picovoice Console (https://console.picovoice.ai/)
handle = pvporcupine.create(access_key=access_key, keywords=['picovoice'])
```
`handle` is an instance of Porcupine that detects utterances of "Picovoice". `keywords` input argument is a shorthand
for accessing default keyword model files shipped with the package. The list of default keywords can be retrieved by
```python
import pvporcupine
print(pvporcupine.KEYWORDS)
```
Porcupine can detect multiple keywords concurrently
```python
import pvporcupine
access_key = "${ACCESS_KEY}" # AccessKey obtained from Picovoice Console (https://console.picovoice.ai/)
handle = pvporcupine.create(access_key=access_key, keywords=['bumblebee', 'picovoice'])
```
To detect non-default keywords use `keyword_paths` input argument instead
```python
import pvporcupine
access_key = "${ACCESS_KEY}" # AccessKey obtained from Picovoice Console (https://console.picovoice.ai/)
keyword_paths = ['/absolute/path/to/keyword/one', '/absolute/path/to/keyword/two', ...]
handle = pvporcupine.create(access_key=access_key, keyword_paths=keyword_paths)
```
The sensitivity of the engine can be tuned per keyword using the `sensitivities` input argument
```python
import pvporcupine
access_key = "${ACCESS_KEY}" # AccessKey obtained from Picovoice Console (https://console.picovoice.ai/)
handle = pvporcupine.create(
access_key=access_key,
keywords=['grapefruit', 'porcupine'],
sensitivities=[0.6, 0.35])
```
Sensitivity is the parameter that enables trading miss rate for the false alarm rate. It is a floating point number within
`[0, 1]`. A higher sensitivity reduces the miss rate at the cost of increased false alarm rate.
When initialized, the valid sample rate is given by `handle.sample_rate`. Expected frame length (number of audio samples
in an input array) is `handle.frame_length`. The engine accepts 16-bit linearly-encoded PCM and operates on
single-channel audio.
```python
def get_next_audio_frame():
pass
while True:
keyword_index = handle.process(get_next_audio_frame())
if keyword_index >= 0:
# detection event logic/callback
pass
```
When done resources have to be released explicitly
```python
handle.delete()
```
## Non-English Wake Words
In order to detect non-English wake words you need to use the corresponding model file. The model files for all supported languages are available [here](https://github.com/Picovoice/porcupine/tree/master/lib/common).
## Demos
[pvporcupinedemo](https://pypi.org/project/pvporcupinedemo/) provides command-line utilities for processing real-time
audio (i.e. microphone) and files using Porcupine.
Raw data
{
"_id": null,
"home_page": "https://github.com/Picovoice/porcupine",
"name": "pvporcupine",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": "",
"keywords": "wake word engine,hotword detection,keyword spotting,wake word detection,voice commands",
"author": "Picovoice",
"author_email": "hello@picovoice.ai",
"download_url": "https://files.pythonhosted.org/packages/b6/4a/5eca7ceb93b72eed5af57b174638df1b32038ea338adb9e54c8d3fc37f64/pvporcupine-3.0.2.tar.gz",
"platform": null,
"description": "# Porcupine Wake Word Engine\n\nMade in Vancouver, Canada by [Picovoice](https://picovoice.ai)\n\nPorcupine is a highly-accurate and lightweight wake word engine. It enables building always-listening voice-enabled\napplications. It is\n\n- using deep neural networks trained in real-world environments.\n- compact and computationally-efficient. It is perfect for IoT.\n- cross-platform:\n - Arm Cortex-M, STM32, Arduino, and i.MX RT \n - Raspberry Pi, NVIDIA Jetson Nano, and BeagleBone\n - Android and iOS\n - Chrome, Safari, Firefox, and Edge\n - Linux (x86_64), macOS (x86_64, arm64), and Windows (x86_64)\n- scalable. It can detect multiple always-listening voice commands with no added runtime footprint.\n- self-service. Developers can train custom wake word models using [Picovoice Console](https://console.picovoice.ai/).\n\n## Compatibility\n\n- Python 3.5+\n- Runs on Linux (x86_64), macOS (x86_64 and arm64), Windows (x86_64), Raspberry Pi, NVIDIA Jetson (Nano), and BeagleBone.\n\n## Installation\n\n```console\npip3 install pvporcupine\n```\n\n## AccessKey\n\nPorcupine requires a valid Picovoice `AccessKey` at initialization. `AccessKey` acts as your credentials when using Porcupine SDKs.\nYou can get your `AccessKey` for free. Make sure to keep your `AccessKey` secret.\nSignup or Login to [Picovoice Console](https://console.picovoice.ai/) to get your `AccessKey`.\n\n## Usage\n\nCreate an instance of the engine\n\n```python\nimport pvporcupine\n\naccess_key = \"${ACCESS_KEY}\" # AccessKey obtained from Picovoice Console (https://console.picovoice.ai/)\n\nhandle = pvporcupine.create(access_key=access_key, keywords=['picovoice'])\n```\n\n`handle` is an instance of Porcupine that detects utterances of \"Picovoice\". `keywords` input argument is a shorthand\nfor accessing default keyword model files shipped with the package. The list of default keywords can be retrieved by\n\n```python\nimport pvporcupine\n\nprint(pvporcupine.KEYWORDS)\n```\n\nPorcupine can detect multiple keywords concurrently\n\n```python\nimport pvporcupine\n\naccess_key = \"${ACCESS_KEY}\" # AccessKey obtained from Picovoice Console (https://console.picovoice.ai/)\n\nhandle = pvporcupine.create(access_key=access_key, keywords=['bumblebee', 'picovoice'])\n```\n\nTo detect non-default keywords use `keyword_paths` input argument instead\n\n```python\nimport pvporcupine\n\naccess_key = \"${ACCESS_KEY}\" # AccessKey obtained from Picovoice Console (https://console.picovoice.ai/)\nkeyword_paths = ['/absolute/path/to/keyword/one', '/absolute/path/to/keyword/two', ...]\n\nhandle = pvporcupine.create(access_key=access_key, keyword_paths=keyword_paths)\n```\n\nThe sensitivity of the engine can be tuned per keyword using the `sensitivities` input argument\n\n```python\nimport pvporcupine\n\naccess_key = \"${ACCESS_KEY}\" # AccessKey obtained from Picovoice Console (https://console.picovoice.ai/)\n\nhandle = pvporcupine.create(\n access_key=access_key,\n keywords=['grapefruit', 'porcupine'],\n sensitivities=[0.6, 0.35])\n```\n\nSensitivity is the parameter that enables trading miss rate for the false alarm rate. It is a floating point number within\n`[0, 1]`. A higher sensitivity reduces the miss rate at the cost of increased false alarm rate.\n\nWhen initialized, the valid sample rate is given by `handle.sample_rate`. Expected frame length (number of audio samples\nin an input array) is `handle.frame_length`. The engine accepts 16-bit linearly-encoded PCM and operates on\nsingle-channel audio.\n\n```python\ndef get_next_audio_frame():\n pass\n\nwhile True:\n keyword_index = handle.process(get_next_audio_frame())\n if keyword_index >= 0:\n # detection event logic/callback\n pass\n```\n\nWhen done resources have to be released explicitly\n\n```python\nhandle.delete()\n```\n\n## Non-English Wake Words\n\nIn order to detect non-English wake words you need to use the corresponding model file. The model files for all supported languages are available [here](https://github.com/Picovoice/porcupine/tree/master/lib/common).\n\n## Demos\n\n[pvporcupinedemo](https://pypi.org/project/pvporcupinedemo/) provides command-line utilities for processing real-time\naudio (i.e. microphone) and files using Porcupine.\n",
"bugtrack_url": null,
"license": "",
"summary": "Porcupine wake word engine.",
"version": "3.0.2",
"project_urls": {
"Homepage": "https://github.com/Picovoice/porcupine"
},
"split_keywords": [
"wake word engine",
"hotword detection",
"keyword spotting",
"wake word detection",
"voice commands"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f5bfec84d7b70dbc14d1b8ff40628d00f841114f16d75ed8fab2ff940055eec5",
"md5": "b9c20dc20d91385d98f373bd1ab5d04e",
"sha256": "359574d98fa3cc5e21393ab79ba32cc1090ce19d240459554bfc70f1c07e993c"
},
"downloads": -1,
"filename": "pvporcupine-3.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b9c20dc20d91385d98f373bd1ab5d04e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 2881739,
"upload_time": "2024-01-30T21:38:49",
"upload_time_iso_8601": "2024-01-30T21:38:49.731812Z",
"url": "https://files.pythonhosted.org/packages/f5/bf/ec84d7b70dbc14d1b8ff40628d00f841114f16d75ed8fab2ff940055eec5/pvporcupine-3.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b64a5eca7ceb93b72eed5af57b174638df1b32038ea338adb9e54c8d3fc37f64",
"md5": "79fa7dcc0222cc3fbfa645a091fa38bc",
"sha256": "2de270c59197f691e14ea6b378cc6d64ed172f6093ac2f5419423cbb62b7831a"
},
"downloads": -1,
"filename": "pvporcupine-3.0.2.tar.gz",
"has_sig": false,
"md5_digest": "79fa7dcc0222cc3fbfa645a091fa38bc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.5",
"size": 2866559,
"upload_time": "2024-01-30T21:38:56",
"upload_time_iso_8601": "2024-01-30T21:38:56.494483Z",
"url": "https://files.pythonhosted.org/packages/b6/4a/5eca7ceb93b72eed5af57b174638df1b32038ea338adb9e54c8d3fc37f64/pvporcupine-3.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-30 21:38:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Picovoice",
"github_project": "porcupine",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pvporcupine"
}