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.0a4-cp311-abi3-win_amd64.whl (7.6 MB view details)

Uploaded CPython 3.11+Windows x86-64

kikita_wake_word_runtime-0.1.0a4-cp311-abi3-manylinux_2_28_x86_64.whl (10.0 MB view details)

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

kikita_wake_word_runtime-0.1.0a4-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.0a4-cp311-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for kikita_wake_word_runtime-0.1.0a4-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 3df98516daacc5f7c29ec381bb48b3be6846051d008629cf5101f1fc9846277a
MD5 214ca662a11f399c6452066b5394290e
BLAKE2b-256 455c7dbe8a2d2d2051680facad473e02becb77a6918e8a1ed969206b71075841

See more details on using hashes here.

Provenance

The following attestation bundles were made for kikita_wake_word_runtime-0.1.0a4-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.0a4-cp311-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for kikita_wake_word_runtime-0.1.0a4-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 520437d3013beecf6bd6c49cbadc5ff84dd3a182290e0e0d35fb6e7d69338949
MD5 4b5d5edd9a7bbac72e99a27a132e076c
BLAKE2b-256 ddcd7b08a79c0871fdcfd17a16f42449a5ff3faaee7962eb921da2782df963a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for kikita_wake_word_runtime-0.1.0a4-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.0a4-cp311-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for kikita_wake_word_runtime-0.1.0a4-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 64d6ed684ca7880858ebeff23c540f94cd57f3de6a54b3bb455d229f44ae7f83
MD5 71850694edf1a4b9267be8eaf3358bd1
BLAKE2b-256 f3b9443cd39af4e6d9ead4f95cb4275dafb36aa87f6e4d8ae741d6783fa54c30

See more details on using hashes here.

Provenance

The following attestation bundles were made for kikita_wake_word_runtime-0.1.0a4-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

This release
Pre-release

0.1.0a4 This release

3 files

Pre-release

0.1.0a3

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