openwakeword

library0.6.0pypypi✓ verified 85d ago

An open-source audio wake word (or phrase) detection framework with a focus on performance and simplicity. Current version is 0.6.0. Releases are periodic with enhancements and bug fixes.

ai-ml llm-agents

pip install openwakeword

github ↗package ↗

INSTALL

IMPORT

SIG · OPENWAKEWORD

openwakeword

ai-mlpythonv0.6.0

Install

14.1s avg

Import

—

Disk

371MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.6.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 14.1s · import 0.000s · 396MB

371MB installed

● package 371MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Model

✓ from openwakeword import Model

✗ from openwakeword import OpenWakeWord

VAD

✓ from openwakeword import VAD

get_pretrained_model_paths

✓ from openwakeword import get_pretrained_model_paths

Initialize the wake word detector and run prediction on audio chunks.

from openwakeword import OpenWakeWord oww = OpenWakeWord() audios = [] # list of audio chunks (numpy arrays) predictions = oww.predict(audios)

openwakeword --version

Debug

Known issues

breakingIn v0.6.0, model files were removed from the package. You must download them separately using `openwakeword.utils.download_models()` or use the CLI.

fix

Run `openwakeword.utils.download_models()` or `python -m openwakeword.utils.download_models` before inference.

affects: >=0.6.0

gotchaThe default inference framework on Linux is tflite since v0.5.0. This may not be installed by default; ensure you have the necessary dependencies.

fix

Install tensorflow or onnxruntime as needed, and specify framework='onnx' if you prefer ONNX.

affects: >=0.5.0

gotchaInput audio must be a list of 1D numpy arrays (dtype=float32) normalized to [-1, 1]. Passing raw integer PCM data will produce incorrect results.

fix

Convert audio to float32 and normalize before passing to predict.

affects: all

Upgrade

Version history

0.6.0latest on PyPI · released Feb 11, 2024

Audit

Dependencies

No dependency data recorded yet.

Agent activity

31 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/dscripka/openWakeWord ↗

packagehttps://pypi.org/project/openwakeword/ ↗