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
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)
| File | Size | Uploaded | |
|---|---|---|---|
| k_flow-0.4.1.tar.gz | 13.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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}
|