Channel-modular voice kernel with contract-first dispatch
Project description
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, aggregateauth).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 ...(scanssrc/flow/channels/, no--channelflag)
- 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 auditflow-stdio auth auditflow-ws auth auditflow-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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
k_flow-0.4.1.tar.gz
(13.7 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
k_flow-0.4.1-py3-none-any.whl
(28.8 kB
view details)
File details
Details for the file k_flow-0.4.1.tar.gz.
File metadata
- Download URL: k_flow-0.4.1.tar.gz
- Upload date:
- Size: 13.7 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e4053c938ad1c1dc9c0c125595de1379d3ada4f21e51ab93548be9c9b5405485
|
|
| MD5 |
3eb15248cbdf42214a256d77db4f648d
|
|
| BLAKE2b-256 |
efbc1cfeb63b693b6f114ac94d6131348934b4c7c9f1e0983936b81de49df28e
|
File details
Details for the file k_flow-0.4.1-py3-none-any.whl.
File metadata
- Download URL: k_flow-0.4.1-py3-none-any.whl
- Upload date:
- Size: 28.8 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
48b2eb32ec1f2801a921b647cb1e5763d5afd733a44f9daf38211ea42e39541b
|
|
| MD5 |
8a683b9eaa4cc09c7088d7a81b4af7cd
|
|
| BLAKE2b-256 |
b3870fed875bc8d0314995e962159faf49f28fa1e228937d6380fb054dc81f1a
|
