docs/RELEASE.md

# Release Checklist

Before uploading a public release:

1. Run the private-path scanner:

   ```bash
   python scripts/check_release.py .
   ```

2. Confirm no large local artifacts are included:

   ```bash
   find . -type f -size +50M
   ```

3. Confirm auth tokens are not present:

   ```bash
   grep -R "hf_" . --exclude-dir=.git --exclude-dir=.cache
   ```

4. Upload to HuggingFace with a token stored only in the environment:

   ```bash
   export HF_TOKEN=...
   python scripts/upload_to_hf.py --namespace WhynotHug
   unset HF_TOKEN
   ```

5. Review the public pages:

   - https://huggingface.co/WhynotHug/PixDLM
   - https://huggingface.co/datasets/WhynotHug/DRSeg

The upload script updates cards, scripts, docs, and metadata without committing
local `data/`, `checkpoints/`, `outputs/`, or `logs/`.