Skip to main content

Environment Reference

The publisher reads a small set of environment values. These values are about publication, not ordinary catalog validation.

HF_TOKEN​

Required for real publication.

The token must have write access to every target Hugging Face repository used by the selected catalog entries and any configured collection. In GitHub Actions, configure it as a repository secret named HF_TOKEN.

SKULK_WEIGHTS_SCRATCH​

Optional.

Sets the scratch root used for local extraction output. LARQL writes vindex directories here before publication.

If unset, the publisher uses .scratch inside the current checkout.

Use fast storage with enough capacity for the selected vindex shape. Full and expert-server outputs exist to support Skulk's runtime placement split, but the publisher still needs local scratch space before anything reaches Hugging Face.

Example:

export SKULK_WEIGHTS_SCRATCH=/fast/scratch/skulk-weights

You can override this for one command with --scratch:

skulk-weights publish \
  --model foxlight/gemma-3-4b-full-q4-k \
  --scratch /fast/scratch/skulk-weights

PATH​

Real publication requires larql to be discoverable on PATH.

Dry-runs do not require larql, because they only print the command plan.

Check the publishing runner with:

skulk-weights doctor --publish

SKULK_WEIGHTS_COLLECTION​

Optional.

Overrides the collection target for a publish command. If unset, each catalog entry uses its own hf_collection value. The built-in Foxlight catalog uses:

FoxlightAI/vindexes-6a124406dd5fb439c431b051

Set this only when you intentionally want all selected entries in that publish run to land in a different collection. A non-disable value must be a valid owner/slug collection slug — publishing raises an error otherwise.

To skip collection filing for a one-off run, set it to any of the disable values (case-insensitive):

none  0  false  no  off  disabled

SKULK_UI_DIST​

Optional.

Overrides the directory that skulk-ui serves the built UI from. Set this when the UI assets live somewhere other than the default bundled dist directory — for example when serving a locally rebuilt UI during development.