betterwithage commited on
Commit
29e41ed
·
verified ·
1 Parent(s): 6fd9491

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
- - khipu
7
- - szl-holdings
8
- - embedding
9
- - silhouette
 
 
10
  ---
11
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
12
  # MiniEmbed-Nano
13
 
14
  Tiny hash+table embed: **V=64, d=12**, L2-normalized rows. **Not a foundation embed. Not neural. Not MiniEmbed 3290×128.**
 
2
  license: apache-2.0
3
  library_name: numpy
4
  tags:
5
+ - governed-ai
6
+ - khipu
7
+ - szl-holdings
8
+ - embedding
9
+ - silhouette
10
+ - needs-loader
11
+ - test-fixture
12
  ---
13
 
14
+ > ### How to actually load this — the weights alone are not enough
15
+ >
16
+ > `mini_embed.npz` is a real, honest hash + table, V=64 d=12 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/MiniEmbed-Nano", "mini_embed.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: no retrieval/analogy score — UNAVAILABLE by design.
36
+
37
  # MiniEmbed-Nano
38
 
39
  Tiny hash+table embed: **V=64, d=12**, L2-normalized rows. **Not a foundation embed. Not neural. Not MiniEmbed 3290×128.**