UX fix: README.md (download instructions / safetensors / pickle-free demo)

README.md

@@ -33,6 +33,22 @@ DELETE zeroes it, CREATE allocates a fresh one, READ is just routing — no retr
 **confidence margin** (top-1 − top-2) is used as an "I don't know which fact you mean" signal, so the
 model refuses low-confidence queries.
 
+## Download
+
+Use the Hugging Face Hub (handles the Git-LFS weights for you). **Don't `git clone` without
+`git-lfs`** — you'd get 132-byte LFS pointer files instead of the real `model.safetensors` / `.pt`.
+
+```bash
+pip install huggingface_hub
+# CPU-only deps (avoids the multi-GB CUDA stack):
+pip install -r requirements.txt --extra-index-url https://download.pytorch.org/whl/cpu
+```
+```python
+from huggingface_hub import snapshot_download
+repo = snapshot_download("TilelliLab/Yaz")     # -> local path with all files (real weights)
+# then: cd into `repo` and run the snippets below, or `python demo.py --demo`.
+```
+
 ## Load it (safetensors, no pickle)
 
 ```python