Development Utilities - Update Assets

SRB uses two git-backed repositories for static content:

• assets/srb_assets for asset payloads.
• docs/src/_graphics for docs/task thumbnails and visuals.

By default, this script updates assets/srb_assets:

./assets/update.bash

To bootstrap from a Hugging Face mirror when submodules are unavailable (private mirrors require HF_TOKEN, HUGGING_FACE_HUB_TOKEN, or hf auth login):

./assets/update.bash --source hf --repo-id <owner>/<repo>

Optional overrides:

./assets/update.bash --source hf --repo-id <owner>/<repo> --repo-type dataset --revision main --path assets/srb_assets

To initialize the graphics repo from Hugging Face:

./assets/update.bash --source hf --repo-id <owner>/<repo> --repo-type dataset --revision main --path docs/src/_graphics

--repo-type defaults to dataset; supported values are model, dataset, and space.

For private mirrors, you can also use environment variables.

export SRB_ASSETS_SOURCE=hf
export SRB_ASSETS_HF_REPO_ID=<owner>/<private-assets-repo-or-dataset>
export SRB_ASSETS_HF_REPO_TYPE=dataset   # or model / space
export SRB_ASSETS_HF_REPO_REVISION=main         # optional

./assets/update.bash

./.docker/build.bash also accepts:

• SRB_ASSETS_... for assets/srb_assets
• SRB_GRAPHICS_... for docs/src/_graphics

Those environment variables are used when a directory is missing and needs bootstrap.