Skip to main content

flow

Channel-modular voice kernel with a single business core and transport-specific channel packages.

Legacy implementation is preserved under old/.

Source of truth

  • CONTRACT.md — API and wrapper contract.
  • ARCHITECTURE.md — modular channel architecture rules.

Runtime binaries

  • flow — global admin (health, status, doctor, aggregate auth).
  • flow-stdio — stdio channel CLI/admin/auth.
  • flow-ws — websocket channel CLI/admin/auth.
  • flow-http — http channel CLI/admin/auth.

Quickstart

make test
uv tool install . --editable --force
flow --help
flow-stdio --help
flow-ws --help
flow-http --help

Auth model

  • Channel-local auth:
    • flow-stdio auth ...
    • flow-ws auth ...
    • flow-http auth ...
  • Global aggregate auth:
    • flow auth ... (scans src/flow/channels/, no --channel flag)
  • Security baseline:
    • API key secrets are returned once on create and stored hashed at rest.
    • Key expiration is supported via --ttl-days.
    • Audit commands:
      • flow auth audit
      • flow-stdio auth audit
      • flow-ws auth audit
      • flow-http auth audit

STT runtime

  • STT orchestration: src/flow/stt/runtime.py
  • Audio normalisation: src/flow/stt/normalise.py
  • Diagnostics only bootstrap: src/flow/bootstrap.py

To enable real STT execution:

export FLOW_ENABLE_REAL_STT=1

Release

  • Distribution name: k-flow (import name: flow)
  • Build/publish/push:
make release

Metadata

Release files for k-flow 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for k-flow 0.4.1
File Size Uploaded
k_flow-0.4.1.tar.gz 13.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for k-flow 0.4.1
File Interpreter ABI Platform
k_flow-0.4.1-py3-none-any.whl Python 3 none any Details

Total release size: 42.6 kB

Release files / k_flow-0.4.1.tar.gz

Download URL k_flow-0.4.1.tar.gz
Size 13.7 kB
Tags Source
SHA-256 checksum
How to use checksums
e4053c938ad1c1dc9c0c125595de1379d3ada4f21e51ab93548be9c9b5405485
BLAKE2b-256 checksum
How to use checksums
efbc1cfeb63b693b6f114ac94d6131348934b4c7c9f1e0983936b81de49df28e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"25.10","id":"questing","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / k_flow-0.4.1-py3-none-any.whl

Download URL k_flow-0.4.1-py3-none-any.whl
Size 28.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
48b2eb32ec1f2801a921b647cb1e5763d5afd733a44f9daf38211ea42e39541b
BLAKE2b-256 checksum
How to use checksums
b3870fed875bc8d0314995e962159faf49f28fa1e228937d6380fb054dc81f1a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"25.10","id":"questing","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.4.1 This release

2 release files

0.3.4

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release 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