betterwithage commited on
Commit
e06fa26
·
verified ·
1 Parent(s): 620b37c

docs: download-ready card — live demo links, install lines, file map (honest labels preserved)

Browse files
Files changed (1) hide show
  1. README.md +24 -8
README.md CHANGED
@@ -25,6 +25,10 @@ szl-governance:
25
 
26
  ## Quickstart
27
 
 
 
 
 
28
  ```python
29
  from kernels import get_kernel
30
 
@@ -93,15 +97,15 @@ print(r["receipt"]["attrs"]["label"], r["receipt"]["attrs"]["joules"])
93
 
94
  | Kernel | Lane | Live hologram |
95
  |---|---|---|
96
- | [`szl-kernels`](https://huggingface.co/SZLHOLDINGS/szl-kernels) | unified suite — cross-kernel `UnifiedReceiptChain` | `szl-kernels-live` *(ROADMAP not yet live)* |
97
- | [`szl-governed-norm`](https://huggingface.co/SZLHOLDINGS/szl-governed-norm) | RMSNorm/LayerNorm + receipts | `governed-norm-holo` *(ROADMAP not yet live)* |
98
- | [`szl-lambda-gate`](https://huggingface.co/SZLHOLDINGS/szl-lambda-gate) | advisory Λ gate (Conjecture 1, OPEN) | `lambda-gate-holo` *(ROADMAP not yet live)* |
99
- | [`governed-inference-meter`](https://huggingface.co/SZLHOLDINGS/governed-inference-meter) | MEASURED-joule energy accounting | `energy-attest-holo` *(ROADMAP not yet live)* |
100
- | [`szl-govsign`](https://huggingface.co/SZLHOLDINGS/szl-govsign) | signed governance attestation (DSSE / in-toto) | `szl-govsign-live` *(ROADMAP not yet live)* |
101
- | [`szl-blocked`](https://huggingface.co/SZLHOLDINGS/szl-blocked) | honest-BLOCKED first-class state + EU AI Act Annex IV | `szl-blocked-live` *(ROADMAP not yet live)* |
102
- | **`szl-provctl`** | **provenance-DAG verify + in-toto/SLSA interop + per-kernel MEASURED energy** | `szl-provctl-live` *(ROADMAP not yet live)* |
103
 
104
- > The `*-live` / `*-holo` hologram Spaces above are ROADMAP (not yet live). The Spaces that **are** live today: [a11oy](https://huggingface.co/spaces/SZLHOLDINGS/a11oy) (live governed inference) · [hatun-mcp](https://huggingface.co/spaces/SZLHOLDINGS/hatun-mcp).
105
 
106
  **Related — Governed Kernels collection:** [Governed Kernels — verifiable AI building blocks](https://huggingface.co/collections/SZLHOLDINGS/governed-kernels-verifiable-ai-building-blocks-6a41d3936cfce4fba83ce378) groups the whole family in one page. **Live console:** [a11oy](https://szlholdings-a11oy.hf.space) · [a-11-oy.com](https://a-11-oy.com) · [llm-router](https://szlholdings-llm-router-live.hf.space) · [receipt verifier](https://szlholdings-governed-receipt-verifier.static.hf.space) · [receipt spec (hub)](https://github.com/szl-holdings/governed-receipt-spec).
107
 
@@ -144,3 +148,15 @@ Honesty (Doctrine v11): Λ unconditional uniqueness is **Conjecture 1** (machine
144
  ```
145
 
146
  *Signed-off-by: Stephen Lutar <stephenlutar2@gmail.com>*
 
 
 
 
 
 
 
 
 
 
 
 
 
25
 
26
  ## Quickstart
27
 
28
+ ```bash
29
+ pip install kernels
30
+ ```
31
+
32
  ```python
33
  from kernels import get_kernel
34
 
 
97
 
98
  | Kernel | Lane | Live hologram |
99
  |---|---|---|
100
+ | [`szl-kernels`](https://huggingface.co/SZLHOLDINGS/szl-kernels) | unified suite — cross-kernel `UnifiedReceiptChain` | [`szl-kernels-live`](https://szlholdings-szl-kernels-live.static.hf.space) **live** |
101
+ | [`szl-governed-norm`](https://huggingface.co/SZLHOLDINGS/szl-governed-norm) | RMSNorm/LayerNorm + receipts | [`governed-norm-holo`](https://szlholdings-governed-norm-holo.static.hf.space) **live** |
102
+ | [`szl-lambda-gate`](https://huggingface.co/SZLHOLDINGS/szl-lambda-gate) | advisory Λ gate (Conjecture 1, OPEN) | [`lambda-gate-holo`](https://szlholdings-lambda-gate-holo.static.hf.space) **live** |
103
+ | [`governed-inference-meter`](https://huggingface.co/SZLHOLDINGS/governed-inference-meter) | MEASURED-joule energy accounting | [`energy-attest-holo`](https://szlholdings-energy-attest-holo.static.hf.space) **live** |
104
+ | [`szl-govsign`](https://huggingface.co/SZLHOLDINGS/szl-govsign) | signed governance attestation (DSSE / in-toto) | [`szl-govsign-live`](https://szlholdings-szl-govsign-live.static.hf.space) **live** |
105
+ | [`szl-blocked`](https://huggingface.co/SZLHOLDINGS/szl-blocked) | honest-BLOCKED first-class state + EU AI Act Annex IV | [`szl-blocked-live`](https://szlholdings-szl-blocked-live.static.hf.space) **live** |
106
+ | **`szl-provctl`** | **provenance-DAG verify + in-toto/SLSA interop + per-kernel MEASURED energy** | [`szl-provctl-live`](https://szlholdings-szl-provctl-live.static.hf.space) **live** |
107
 
108
+ > All the demo Spaces above are **live** (static, in-browser). Also live: [a11oy](https://huggingface.co/spaces/SZLHOLDINGS/a11oy) (live governed inference) · [hatun-mcp](https://huggingface.co/spaces/SZLHOLDINGS/hatun-mcp).
109
 
110
  **Related — Governed Kernels collection:** [Governed Kernels — verifiable AI building blocks](https://huggingface.co/collections/SZLHOLDINGS/governed-kernels-verifiable-ai-building-blocks-6a41d3936cfce4fba83ce378) groups the whole family in one page. **Live console:** [a11oy](https://szlholdings-a11oy.hf.space) · [a-11-oy.com](https://a-11-oy.com) · [llm-router](https://szlholdings-llm-router-live.hf.space) · [receipt verifier](https://szlholdings-governed-receipt-verifier.static.hf.space) · [receipt spec (hub)](https://github.com/szl-holdings/governed-receipt-spec).
111
 
 
148
  ```
149
 
150
  *Signed-off-by: Stephen Lutar <stephenlutar2@gmail.com>*
151
+
152
+ ## Files in this repo
153
+
154
+ | Path | What it is |
155
+ |---|---|
156
+ | `build/torch-universal/szl_provctl/__init__.py` | public API — statements, DAG verify, `selfcheck()` |
157
+ | `build/torch-universal/szl_provctl/_interop.py` | in-toto Statement v1 + SLSA v1 provenance builders |
158
+ | `build/torch-universal/szl_provctl/_dag.py` | provenance-DAG build + re-verify + tamper detection |
159
+ | `build/torch-universal/szl_provctl/_energy.py` | per-kernel MEASURED energy accounting |
160
+ | `build/torch-universal/szl_provctl/_chain.py` | receipt chain (SHA3-256) |
161
+ | `build.toml` · `metadata.json` | Kernel Hub build/metadata manifests |
162
+ | `LICENSE` · `SECURITY.md` | Apache-2.0 · security policy |