sonnetics 0.0.1b4

Wake-word inference for Python. High-level API over sonnetics-core.

sonnetics (Python)

Add a custom “Hey ___” wake word to your project—train a phrase on sonnetics.com, then run detection locally with this library. No audio leaves your machine; the client is open source and does not phone home.

High-level Python API over sonnetics-core.

Get a model

1. Sign in and create a wake word on the Model Dashboard (training is free; you’ll get an email when it’s ready).
2. Copy your model ID from the dashboard and use it below.

Treat the model ID like a secret link—anyone with it can download your model file.

Install

pip install sonnetics

Or with uv:

uv add sonnetics

Requires Python 3.9+.

Quick start

from sonnetics import WakeWordDetector

detector = WakeWordDetector.create(
    model_id="your-model-id",
)

for event in detector.listen():
    print(f"Detected: {event.phrase}")
    break

listen() blocks on the default microphone until a detection.

Examples

More samples in examples/:

See the Python documentation for full API details.

Configuration

Set SONNETICS_CACHE_DIR to change where downloaded models are stored (default: ~/.cache/sonnetics on Linux). Handy in CI, containers, or read-only home directories.

Links

• Full Python docs
• All client libraries (JavaScript, Rust)
• Issues · [e-mail]