buley commited on
Commit
77bbada
·
verified ·
1 Parent(s): 1907de4

Upload README.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. README.md +10 -6
README.md CHANGED
@@ -19,10 +19,11 @@ One image in, one 3D Gaussian splat out: the [Speri Labs Idol](https://huggingfa
19
  pipeline with the [Idol Turbo](https://huggingface.co/speridlabs/idol-turbo) phase-LoRA distill
20
  (5 guidance-free steps), packaged for the Forkjoin/Edgework mesh with its admission receipt.
21
 
22
- > **Honest status: STRUCTURAL admission only.** This package is a byte-identical redistribution of the
23
- > Apache-2.0 weights plus a checked structural receipt. It is **not** a `.knot` (no knot encoder exists
24
- > for this architecture), it has **no visible-tier admission** (no 3DGS renderer or recognisability
25
- > oracle is enrolled), and the shipped sample is a 1-step, cfg-0 probe render — not a quality reference.
 
26
 
27
  ## What is admitted, and what is not
28
 
@@ -31,7 +32,7 @@ pipeline with the [Idol Turbo](https://huggingface.co/speridlabs/idol-turbo) pha
31
  | artifact is a well-formed 3DGS PLY | **ADMITTED (structural)** | `monster-guard qspec verify-modality idol-3d.qspec.json armchair.ply` → `monster-guard.modality-receipt/v1` |
32
  | finite values, zero normals, unit quaternions, distinct xyz, bounded log-scale/opacity | **ADMITTED** | receipt `checks` block (see `receipt.json`) |
33
  | recognisable object / prompt-faithful / visible render | **NOT CLAIMED — refused by construction** | verifier refuses `gate_tier: visible`; no renderer exists yet |
34
- | canonical `.knot` encoding | **NOT PROVIDED** | `encode-knot.py` supports transformer + FLUX archs only |
35
 
36
  ## Files
37
 
@@ -44,6 +45,7 @@ pipeline with the [Idol Turbo](https://huggingface.co/speridlabs/idol-turbo) pha
44
  | `birefnet.safetensors` | 444,466,856 | `44bbc97b041f879975d0d6d538b8e66a25eb04d1f49aab40697544cdd97eaa8e` |
45
  | `idol_turbo_lora.safetensors` | 117,484,528 | `2e4b089211c5d79354f8b67d512f9b436248ac072cea171f56d393a248f7bf66` |
46
  | `turbo.py` | 5,817 | `d607930134bc1375b5b9d652a2bab8ca0b38f7eceef973686a5dba96b6b2d264` |
 
47
 
48
  Also included: `idol-3d.qspec.json` (the modality gate), `receipt.json` (the checked
49
  `monster-guard.modality-receipt/v1`), `probe_splat.py` (standalone structural probe) and
@@ -111,7 +113,9 @@ output.gaussian.save_ply("photo.ply")
111
  the gated originals is unverified.
112
  - The sample artifact is 1 step at `cfg=0`; it exists to prove the structural gate and the artifact path,
113
  not image quality.
114
- - No `.knot` encoding: the sovereign Rust runtime has no Idol pipeline yet.
 
 
115
  - License and credit: base weights and turbo distill are Apache-2.0 from Speri Labs
116
  ([idol](https://huggingface.co/speridlabs/idol), [idol-turbo](https://huggingface.co/speridlabs/idol-turbo)).
117
  This package adds packaging, the qspec and the structural receipt only.
 
19
  pipeline with the [Idol Turbo](https://huggingface.co/speridlabs/idol-turbo) phase-LoRA distill
20
  (5 guidance-free steps), packaged for the Forkjoin/Edgework mesh with its admission receipt.
21
 
22
+ > **Honest status: STRUCTURAL admission only.** This package ships **two artifacts**: the loadable
23
+ > safetensors set, and a KNOT v1 **container** (`idol-turbo.knot`, 3.64 GB, 2,138 tensors,
24
+ > round-trip verified) that is an archive — the sovereign runtime has **no Idol pipeline**, so the
25
+ > knot is not executable. No visible-tier admission (no 3DGS renderer or recognisability oracle), and
26
+ > the shipped sample is a 1-step, cfg-0 probe render — not a quality reference.
27
 
28
  ## What is admitted, and what is not
29
 
 
32
  | artifact is a well-formed 3DGS PLY | **ADMITTED (structural)** | `monster-guard qspec verify-modality idol-3d.qspec.json armchair.ply` → `monster-guard.modality-receipt/v1` |
33
  | finite values, zero normals, unit quaternions, distinct xyz, bounded log-scale/opacity | **ADMITTED** | receipt `checks` block (see `receipt.json`) |
34
  | recognisable object / prompt-faithful / visible render | **NOT CLAIMED — refused by construction** | verifier refuses `gate_tier: visible`; no renderer exists yet |
35
+ | knot **container** | **PROVIDED (archive only)** | `idol-turbo.knot` — 3,638,843,041 B, 2,138 tensors, KNOT v1, round-trip verified (`knot-receipt.json`); no sovereign Idol loader exists, so it is not executable |
36
 
37
  ## Files
38
 
 
45
  | `birefnet.safetensors` | 444,466,856 | `44bbc97b041f879975d0d6d538b8e66a25eb04d1f49aab40697544cdd97eaa8e` |
46
  | `idol_turbo_lora.safetensors` | 117,484,528 | `2e4b089211c5d79354f8b67d512f9b436248ac072cea171f56d393a248f7bf66` |
47
  | `turbo.py` | 5,817 | `d607930134bc1375b5b9d652a2bab8ca0b38f7eceef973686a5dba96b6b2d264` |
48
+ | `idol-turbo.knot` (archive) | 3,638,843,041 | `c5a19cb7ef8d2f18521331c0aa67d7dadf6e0debbb0aa06ee8417e46b51e3210` |
49
 
50
  Also included: `idol-3d.qspec.json` (the modality gate), `receipt.json` (the checked
51
  `monster-guard.modality-receipt/v1`), `probe_splat.py` (standalone structural probe) and
 
113
  the gated originals is unverified.
114
  - The sample artifact is 1 step at `cfg=0`; it exists to prove the structural gate and the artifact path,
115
  not image quality.
116
+ - The `.knot` is a **container, not a loadable model**: KNOT v1 holds the 2,138 fp32 tensors with
117
+ per-tensor shape/digest metadata, but no sovereign Idol pipeline can execute it yet. Loading it as
118
+ a model would be a claim the runtime cannot honour.
119
  - License and credit: base weights and turbo distill are Apache-2.0 from Speri Labs
120
  ([idol](https://huggingface.co/speridlabs/idol), [idol-turbo](https://huggingface.co/speridlabs/idol-turbo)).
121
  This package adds packaging, the qspec and the structural receipt only.