Pre-release

This release is a pre-release and may not be stable for production use.

Kikita Wake Word Runtime for Python

Typed Python binding for validating, inspecting, producing, and running .kww model bundles through the shared Rust core.

pip install --pre kikita-wake-word-runtime

from kikita_wake_word_runtime import open_bundle

with open_bundle("model.kww") as bundle:
    print(bundle.manifest.bundle_id)

Forge and other trusted producer applications create bundles through the same package:

from kikita_wake_word_runtime import write_bundle

write_bundle(
    "model.kww",
    manifest,
    {
        "mel": mel_path,
        "embedding": embedding_path,
        "classifier": classifier_path,
    },
)

The writer validates sizes and SHA-256 values, writes a deterministic archive, reopens it through the secure loader, and atomically publishes the completed .kww.

from kikita_wake_word_runtime import WakeWordModel

model = WakeWordModel.from_bundle("model.kww")
stream = model.create_stream(source_sample_rate_hz=48_000)

for result in stream.process_pcm_s16le(discord_pcm):
    if result.detected:
        print(result.candidate_score, result.verifier_score, result.score)

WakeWordModel shares immutable ONNX sessions. Create one WakeWordStream per ordered mono PCM source. Input buffers are copied. Call finish() at end of a finite source or reset() before reusing stream state. A model may serve multiple streams concurrently; calls on one mutable stream must remain ordered and must not run concurrently.

Candidate-only and embedded ONNX verifier bundles run offline. An external verifier dependency is accepted by the manifest parser but model loading fails closed until that exact dependency is supplied through a future resolver API.

The wheel contains the Rust core and statically linked ONNX Runtime. End users need Python 3.11 or newer and a supported prebuilt platform, not Rust or a separate onnxruntime package.

Supported by the first alpha: Windows x64, manylinux_2_28 x64, and Apple Silicon macOS. See the repository for the .kww specification, compatibility matrix, security policy, and release notes.

Project links

Data verified by PyPI on Aug 7, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.0a5)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for kikita13 from gravatar.com kikita13

Credits

Author: Kikita Labs

GitHub Statistics

Data verified by PyPI on Aug 7, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev

Tags

wake-word keyword-spotting speech-recognition onnx audio kww

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

kikita_wake_word_runtime-0.1.0a3-cp311-abi3-win_amd64.whl (7.6 MB view details)

Uploaded CPython 3.11+Windows x86-64

kikita_wake_word_runtime-0.1.0a3-cp311-abi3-manylinux_2_28_x86_64.whl (9.9 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ x86-64

kikita_wake_word_runtime-0.1.0a3-cp311-abi3-macosx_11_0_arm64.whl (8.7 MB view details)

Uploaded CPython 3.11+macOS 11.0+ ARM64

File details

Details for the file kikita_wake_word_runtime-0.1.0a3-cp311-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for kikita_wake_word_runtime-0.1.0a3-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 d7895756436ac9e528939c6068a696d057a059514f94521fa162605f39052518
MD5 6e557d21b2389413bb45d5c7cd3b11a0
BLAKE2b-256 9e42e7ba71cf5446c526f6fed7b86ba60d524a6244ceebc6d9897f487abb4383

See more details on using hashes here.

Provenance

The following attestation bundles were made for kikita_wake_word_runtime-0.1.0a3-cp311-abi3-win_amd64.whl:

Publisher: publish.yml on kikita-labs/wake-word-runtime

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file kikita_wake_word_runtime-0.1.0a3-cp311-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for kikita_wake_word_runtime-0.1.0a3-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 76f695f0e504e32ac1b5cfaf76ca7cab24d33afc3e60762a2200427e9f4207f0
MD5 9429aa536a07c7c02cd725f542df7541
BLAKE2b-256 1eadcd3d55552910ec4e4e26f4c01998242e9ac79476c5484f8254b8f8fac13d

See more details on using hashes here.

Provenance

The following attestation bundles were made for kikita_wake_word_runtime-0.1.0a3-cp311-abi3-manylinux_2_28_x86_64.whl:

Publisher: publish.yml on kikita-labs/wake-word-runtime

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file kikita_wake_word_runtime-0.1.0a3-cp311-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for kikita_wake_word_runtime-0.1.0a3-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 dc1f47a7067d19331aff70b3a74e4d5cd7afd6eb0a20e97405fcf32bf0c236a2
MD5 50efb861805c57fca39e05c436e17511
BLAKE2b-256 41d348f2bceebd967b7a880747a9a1516a784e0dae76140d56ba6f6ec1b3044c

See more details on using hashes here.

Provenance

The following attestation bundles were made for kikita_wake_word_runtime-0.1.0a3-cp311-abi3-macosx_11_0_arm64.whl:

Publisher: publish.yml on kikita-labs/wake-word-runtime

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

Pre-release

0.1.0a5

3 files

Pre-release

0.1.0a4

3 files

This release
Pre-release

0.1.0a3 This release

3 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page