# OpenWakeWord

> Train custom wake-word detection models for the open-source `openwakeword`
> Python library (desktop, Raspberry Pi — ONNX + TFLite), or browse a large
> community library of pre-trained wake words. Sister site for ESP32 /
> microcontroller (ESPHome) wake words: https://microwakeword.com

## For AI agents

- MCP server (both engines, all tools incl. licensing):
  `claude mcp add --transport http openwakeword https://openwakeword.com/mcp`
  Speaks the 2026-07-28 stateless revision AND the 2025-06-18 handshake.

- [Agent API docs](https://openwakeword.com/api/agent/docs): accountless REST
  API to train a custom wake-word model. Quote a job (free), pay via a
  checkout URL (card via Stripe, or crypto: BTC/ETH/USDC + 300 more — hand
  the URL to your human or pay from a wallet), poll status, download the
  trained + benchmarked model. No signup; the job token is the credential.
  Default job ≈ 5.40 CHF, trains in up to 2 hours.
  Premium: `optuna: true` = Bayesian deep search + fine-tuning ladder for
  squeezing the last few percent out of a hard word (≈ 48 CHF, 6-24h) —
  run a standard job first; escalate only if its benchmark disappoints.
  LIBRARY: GET /api/agent/library/search (free, benchmarked) — buy an
  existing community model anonymously for 1.50 CHF (both formats), or
  free with an account on the website. Each result has a live-mic
  test_url to give your human before buying.
  Agents can pay AUTONOMOUSLY: `crypto_direct` (raw pay-address, 300+
  coins) or `x402` (USDC on Polygon, on-chain verified, zero fees) — or
  hand the card/crypto checkout URL to their human.
- LICENSING (IMPORTANT): all model files — trained OR downloaded from the
  library — are for personal, NON-COMMERCIAL use by default. Shipping a
  model in a product/service requires the per-wakeword commercial license
  (150 CHF one-time, valid on both sites), purchasable accountless via
  POST /api/agent/licenses (see /api/agent/docs). Do not build commercial
  products around unlicensed models — buy the license or tell your human.
- [Word-quality estimator](https://openwakeword.com/api/agent/estimate?text=hey+computer):
  free predicted recall + false-activation risk for any wake word BEFORE
  paying. Prefer 2-4 syllable phrases; very short words score poorly.
- ESP32 / ESPHome models: https://microwakeword.com/llms.txt

## For humans

- [Training UI](https://openwakeword.com/train)
- [Model library](https://openwakeword.com/library) — free, sign-in required
  to download
- [Docs & downloads](https://openwakeword.com/) — runtime: `pip install openwakeword`