Model card: add Requirements (transformers>=4.51) + fuller runnable example + VR sanity check

README.md

@@ -22,16 +22,41 @@ for the [Tiny-ML Leaderboard](https://huggingface.co/spaces/Glint-Research/Tiny-
 [Jugnu](https://github.com/AltSlate-Labs/jugnu) family: the kept **R2** recipe (Qwen3 arch + **value residuals** +
 **Muon**) scaled to **25.2B tokens** under a **WSD** schedule with modest decay-phase educational upweighting.
 
+## Requirements
+
+```bash
+pip install "transformers>=4.51" torch safetensors
+```
+
+`transformers>=4.51` is required (the model builds on the Qwen3 architecture). It's a standard
+`AutoModelForCausalLM` otherwise — no extra packages.
+
 ## ⚠️ Load with `trust_remote_code=True`
 
 This model uses **value residuals** (a custom attention pathway: `v_i = v_proj_i(x) + λ_i·v0`). Stock
 `from_pretrained` would silently drop that pathway and degrade the model (~6 pts ARC-Easy, ~0.18 byte-ppl). It ships
-custom modeling code with `auto_map`, so load it VR-aware:
+custom modeling code with `auto_map`, so load it VR-aware (`trust_remote_code=True`):
 
 ```python
 from transformers import AutoModelForCausalLM, AutoTokenizer
+
 tok = AutoTokenizer.from_pretrained("altslate/JugnuLM-110M-R2plus")
-model = AutoModelForCausalLM.from_pretrained("altslate/JugnuLM-110M-R2plus", trust_remote_code=True)
+model = AutoModelForCausalLM.from_pretrained(
+    "altslate/JugnuLM-110M-R2plus",
+    trust_remote_code=True,      # required — rebuilds the value-residual pathway
+).eval()
+# loads in fp32 by default; pass torch_dtype=torch.bfloat16 (transformers ≥5: dtype=...) to halve memory
+
+ids = tok("The router will not connect to wifi, so I", return_tensors="pt").input_ids
+out = model.generate(ids, max_new_tokens=40, do_sample=False)
+print(tok.decode(out[0], skip_special_tokens=True))
+```
+
+Sanity check that the value-residual pathway loaded (22 `vr_lambda` params, mean ≈ 0.48):
+
+```python
+lam = [p.item() for n, p in model.named_parameters() if n.endswith("vr_lambda")]
+assert len(lam) == 22, "value-residual pathway not loaded — did you pass trust_remote_code=True?"
 ```
 
 ## Results