atelier: one-of-one card — cut, silhouette, GitHub Python. YAML preserved.
Browse files
README.md
CHANGED
|
@@ -22,6 +22,38 @@ from szl_khipu.train import mini_embed
|
|
| 22 |
|
| 23 |
emb = mini_embed.build(seed=20260721)
|
| 24 |
vec = emb.embed("knot the run")
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 25 |
print(emb.V, emb.D, vec.shape)
|
| 26 |
# 64 12 (12,)
|
| 27 |
emb.save_npz("mini_embed.npz")
|
|
|
|
| 22 |
|
| 23 |
emb = mini_embed.build(seed=20260721)
|
| 24 |
vec = emb.embed("knot the run")
|
| 25 |
+
|
| 26 |
+
|
| 27 |
+
<!-- SZL-ATELIER-CUT:v1:START -->
|
| 28 |
+
## The cut
|
| 29 |
+
|
| 30 |
+
Nobody ships an embedding where retrieval is provenance. MiniEmbed is not BGE, not NV-Embed. Mean-pool of L2 rows, seed 20260721, CPU NumPy.
|
| 31 |
+
|
| 32 |
+
An embedding you can re-derive bit-exact from the seed. No SGD theater. Cosine is a claim about the table, not a vibe.
|
| 33 |
+
|
| 34 |
+
### Silhouette → leave → SZL
|
| 35 |
+
|
| 36 |
+
| Leader | Take, then tweak |
|
| 37 |
+
|---|---|
|
| 38 |
+
| Anthropic | Honest about what it is not — not a foundation embed. |
|
| 39 |
+
| NVIDIA | Tiny table instead of NV-Embed / NeMo retrieval stacks. |
|
| 40 |
+
| Unsloth | No LoRA. Construction is `build(seed)` — Unsloth is the wrong tool and we say so. |
|
| 41 |
+
|
| 42 |
+
Nobody else ships this combination. That is the point of a one-of-one.
|
| 43 |
+
|
| 44 |
+
## Intended use
|
| 45 |
+
|
| 46 |
+
Silhouette of receipted retrieval. Teaching and tests.
|
| 47 |
+
|
| 48 |
+
## Limitations
|
| 49 |
+
|
| 50 |
+
- Not a neural embed.
|
| 51 |
+
- Not comparable to BGE-base 768-d.
|
| 52 |
+
- Hit@2 is on five doctrine pairs — SAMPLE.
|
| 53 |
+
|
| 54 |
+
Canonical GitHub: [`szl-holdings/szl-khipu`](https://github.com/szl-holdings/szl-khipu/blob/main/szl_khipu/train/mini_embed.py)
|
| 55 |
+
<!-- SZL-ATELIER-CUT:v1:END -->
|
| 56 |
+
|
| 57 |
print(emb.V, emb.D, vec.shape)
|
| 58 |
# 64 12 (12,)
|
| 59 |
emb.save_npz("mini_embed.npz")
|