Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Development Utilities - Update Assets

SRB keeps 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

You can also bootstrap from a Hugging Face mirror when submodules are not available (private mirror support requires auth via HF_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 /path/to/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 /path/to/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.