docs/HF_RELEASE_STEPS.md

# Hugging Face release steps

Suggested repository ID: `kiruluta/Spectral-World-Models-Reproducibility`

1. Install/update CLI: `pip install -U huggingface_hub`
2. Authenticate: `hf auth login`
3. Create repository: `hf repos create kiruluta/Spectral-World-Models-Reproducibility --exist-ok`
4. From the directory containing this folder, upload it to repository root:
   `hf upload kiruluta/Spectral-World-Models-Reproducibility ./Spectral-World-Models-HF-Reproducibility-Final . --exclude '.pytest_cache/**' --exclude '**/__pycache__/**' --exclude '*.pyc'`
5. Verify README, source, scripts, tests, versioned V6–V15.1 documents, and `results/` on the Hub.
6. Create a frozen tag after verification:
   `hf repos tag create kiruluta/Spectral-World-Models-Reproducibility v15.1-final -m "Final SWM reproducibility release through V15.1"`

Do not upload access tokens, virtual environments, caches, or unrelated local checkpoints.