betterwithage commited on
Commit
ce0e089
·
verified ·
1 Parent(s): 1035caa

docs: state that the loader lives in a different repo

Browse files

The npz weights are real and the card does not overstate them, but there is no config.json and no loader here, so from_pretrained and the inference widget cannot load it and nothing documents the array names or forward pass. Adds a working hf_hub_download snippet, points at szl_khipu in szl-khipu-kernels as the forward pass this was trained against, and labels the repo a test fixture rather than a deployable model until the loader ships alongside the weights.

Files changed (1) hide show
  1. README.md +30 -5
README.md CHANGED
@@ -2,13 +2,38 @@
2
  license: apache-2.0
3
  library_name: numpy
4
  tags:
5
- - governed-ai
6
- - szl-holdings
7
- - doctrine-v11
8
- - nano
9
- - synthetic
 
 
10
  ---
11
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
12
  # ReceiptAgent-Nano
13
 
14
  ALLOW · DENY · ABSTAIN · ESCALATE. Escalation is a class, not a retry loop.
 
2
  license: apache-2.0
3
  library_name: numpy
4
  tags:
5
+ - governed-ai
6
+ - szl-holdings
7
+ - doctrine-v11
8
+ - nano
9
+ - synthetic
10
+ - needs-loader
11
+ - test-fixture
12
  ---
13
 
14
+ > ### How to actually load this — the weights alone are not enough
15
+ >
16
+ > `receipt_agent.npz` is a real, honest 4-10-4 MLP produced by a real training run, and the card
17
+ > below does not overstate it. But it is a bare NumPy archive with **no
18
+ > `config.json` and no loader in this repo**, so `from_pretrained` and the Hub
19
+ > inference widget cannot touch it. Nothing here tells you the array names or the
20
+ > forward pass.
21
+ >
22
+ > ```python
23
+ > import numpy as np
24
+ > from huggingface_hub import hf_hub_download
25
+ >
26
+ > path = hf_hub_download("SZLHOLDINGS/ReceiptAgent-Nano", "receipt_agent.npz")
27
+ > w = np.load(path)
28
+ > print(sorted(w.files)) # array names are the de-facto interface
29
+ > ```
30
+ >
31
+ > The forward pass this was trained against lives in the `szl_khipu` package, in
32
+ > [SZLHOLDINGS/szl-khipu-kernels](https://huggingface.co/SZLHOLDINGS/szl-khipu-kernels)
33
+ > — a **different repository**. Until the loader ships alongside the weights (or a
34
+ > `custom_code` handler is added), treat this repo as a **test fixture**, not a
35
+ > deployable model. Evidence status: see TRAINING_RECEIPT.json / BENCH.*.json (SYNTHETIC).
36
+
37
  # ReceiptAgent-Nano
38
 
39
  ALLOW · DENY · ABSTAIN · ESCALATE. Escalation is a class, not a retry loop.