Docs: mount model repo as a read-only volume for the checkpoint

HF replaced the fixed persistent-storage disk with mounted volumes. Recommend
mounting the model repo (read-only) so the checkpoint is a local file at
/models/checkpoint.pt (FACEANYTHING_CHECKPOINT) — no download, nothing to re-fetch
on cold start. Keep the hf_hub_download path as an alternative, with a Storage
Bucket volume backing HF_HOME for cache persistence.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

README.md

@@ -51,35 +51,51 @@ The Gradio code (`app.py`) and the model source (`src/faceanything`,
 `src/depth_anything_3`) are included here. To make the Space runnable you still
 need the **checkpoint** (~15 GB), which is not committed.
 
-### Checkpoint storage (recommended: a separate HF model repo)
+### Checkpoint storage
 
-Don't commit 15 GB into the Space repo. Upload the checkpoint to its own Hugging
-Face **model** repo once, and let the app pull it at startup:
+Don't commit 15 GB into the Space repo. Put the checkpoint in a Hugging Face
+**model** repo and expose it to the Space with a mounted volume (HF's current
+mechanism for persisting data — the old fixed persistent-storage disk has been
+superseded by volumes / storage buckets).
+
+**Recommended — mount the model repo as a read-only volume.** The checkpoint then
+appears as a plain local file; no download code, nothing to re-fetch on cold
+start, and zero ZeroGPU seconds spent moving it.
 
 ```bash
-# one-time upload (make the repo private and add an HF_TOKEN secret if you like)
-hf upload UmutKocasari/FaceAnything-weights /path/to/checkpoint.pt checkpoint.pt --repo-type=model
+# one-time: upload the checkpoint into your model repo
+hf upload UmutKocasari/FaceAnything /path/to/checkpoint.pt checkpoint.pt --repo-type=model
+
+# mount that model repo into the Space at /models (read-only) — restarts the Space
+hf spaces volumes set UmutKocasari/FaceAnything \
+    -v hf://models/UmutKocasari/FaceAnything:/models
 ```
 
-Then set on the Space (*Settings → Variables and secrets*):
+Then set one Space variable (*Settings → Variables and secrets*):
 
 ```
-FACEANYTHING_CHECKPOINT_REPO = UmutKocasari/FaceAnything-weights
-HF_TOKEN = hf_...            # only if the repo is private
-HF_HOME  = /data/.huggingface   # with Persistent Storage enabled (see below)
+FACEANYTHING_CHECKPOINT = /models/checkpoint.pt
 ```
 
-`hf_hub_download` caches the file, so it transfers once (and is HF-internal, so
-fast). The app resolves the checkpoint at **startup on the CPU node**, so the
-download never eats into ZeroGPU compute time.
+Add the `HF_TOKEN` secret too if the model repo is private. Verify the mount with
+`hf spaces volumes ls UmutKocasari/FaceAnything`. (Models/datasets are always
+read-only mounts; only storage buckets can be mounted read-write.)
+
+**Alternative — download at startup.** Skip the volume and set
+`FACEANYTHING_CHECKPOINT_REPO = UmutKocasari/FaceAnything`; the app calls
+`hf_hub_download` on the CPU node at startup. It re-downloads on each cold start
+unless you back the HF cache with a read-write **Storage Bucket** volume and point
+`HF_HOME` at it:
 
-**Enable Persistent Storage** on the Space and point `HF_HOME` at it
-(`/data/.huggingface`) so the 15 GB cache survives restarts instead of
-re-downloading on every cold start.
+```bash
+hf buckets create UmutKocasari/faceanything-cache
+hf spaces volumes set UmutKocasari/FaceAnything \
+    -v hf://buckets/UmutKocasari/faceanything-cache:/data
+# then set Space variable:  HF_HOME = /data/.huggingface
+```
 
-*Alternatives:* commit it via Git LFS at `checkpoints/checkpoint.pt` (simplest,
-but bloats the Space repo and slows clones — fine only if you accept that), or
-set `FACEANYTHING_CHECKPOINT` to an already-present local path.
+*Last resort:* commit the weights via Git LFS at `checkpoints/checkpoint.pt`
+(bloats the Space repo and slows every clone).
 
 ### Hardware