SKILL.md · 24000
]]`
hf repos settings REPO_ID— Update the settings of a repository.[--gated [auto|manual|false] --private --public --protected --type [model|dataset|space|kernel] --format [auto|human|agent|json|quiet]]hf repos tag create REPO_ID TAG— Create a tag for a repo.[--message TEXT --revision TEXT --type [model|dataset|space|kernel] --format [auto|human|agent|json|quiet]]hf repos tag delete REPO_ID TAG— Delete a tag for a repo.[--yes --type [model|dataset|space|kernel] --format [auto|human|agent|json|quiet]]hf repos tag list REPO_ID— List tags for a repo.[--type [model|dataset|space|kernel] --format [auto|human|agent|json|quiet]]
hf sandbox — Run and manage experimental sandboxes on Hugging Face Jobs.
hf sandbox cp SRC DST— Copy a file between the local machine and a sandbox (docker-style).[--namespace TEXT --format [auto|human|agent|json|quiet]]hf sandbox create— Create a sandbox: a dedicated VM by default, or a cheap shared one with--pool.[--pool TEXT --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --idle-timeout TEXT --env TEXT --secrets TEXT --label TEXT --env-file TEXT --secrets-file TEXT --volume TEXT --namespace TEXT --forward-hf-token --format [auto|human|agent|json|quiet]]hf sandbox exec SANDBOX_ID COMMAND— Run a command in a sandbox, streaming output. Exits with the command's exit code.[--workdir TEXT --env TEXT --env-file TEXT --timeout FLOAT --namespace TEXT]hf sandbox kill— Terminate a sandbox, a whole shared host, or everything (--all).[--all --yes --namespace TEXT --format [auto|human|agent|json|quiet]]hf sandbox pool create— Warm a pool: boot one host VM now, tagged so it can be found later by its pool id.[--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --per-host INTEGER RANGE --max-hosts INTEGER RANGE --idle-timeout TEXT --namespace TEXT --format [auto|human|agent|json|quiet]]hf sandbox pool delete POOL_ID— Terminate every host VM of a pool (and therefore all its sandboxes).[--yes --namespace TEXT --format [auto|human|agent|json|quiet]]hf sandbox pool ls— List running sandbox pools (grouped from their host VMs).[--namespace TEXT --format [auto|human|agent|json|quiet]]hf sandbox process kill SANDBOX_ID PID— Stop a background process running in a sandbox.[--namespace TEXT --format [auto|human|agent|json|quiet]]hf sandbox process ls SANDBOX_ID— List the background processes running in a sandbox (started withhf sandbox spawn).[--namespace TEXT --format [auto|human|agent|json|quiet]]hf sandbox spawn SANDBOX_ID COMMAND— Start a long-running command in the background and return its pid (don't wait).[--workdir TEXT --env TEXT --env-file TEXT --namespace TEXT]
hf skills — Manage skills for AI assistants.
hf skills add— Install a Hugging Face skill for an AI assistant.[--global --dest PATH --force --format [auto|human|agent|json|quiet]]hf skills list— List available skills from the Hugging Face marketplace.[--format [auto|human|agent|json|quiet]]hf skills preview— Print the generatedhf-cliSKILL.md to stdout.[--format [auto|human|agent|json|quiet]]hf skills update— Update installed Hugging Face marketplace skills.[--global --dest PATH --format [auto|human|agent|json|quiet]]
hf spaces — Interact with spaces on the Hub.
hf spaces card SPACE_ID— Get the Space card (README) for a Space on the Hub.[--metadata --text --format [auto|human|agent|json|quiet]]hf spaces dev-mode SPACE_ID— Enable or disable dev mode on a Space.[--stop --format [auto|human|agent|json|quiet]]hf spaces hardware— List available hardware options for Spaces.[--format [auto|human|agent|json|quiet]]hf spaces hot-reload SPACE_ID— Hot-reload any Python file of a Space without a full rebuild + restart.[--local-file PATH --skip-checks --skip-summary --format [auto|human|agent|json|quiet]]hf spaces info SPACE_ID— Get info about a space on the Hub.[--revision TEXT --expand TEXT --format [auto|human|agent|json|quiet]]hf spaces list— List spaces on the Hub, or files in a space repo.[--search TEXT --author TEXT --filter TEXT --sort [created_at|last_modified|likes|trending_score] --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format [auto|human|agent|json|quiet]]hf spaces logs SPACE_ID— Fetch the run or build logs of a Space.[--build --follow --tail INTEGER --format [auto|human|agent|json|quiet]]hf spaces pause SPACE_ID— Pause a Space.[--format [auto|human|agent|json|quiet]]hf spaces restart SPACE_ID— Restart a Space.[--factory-reboot --format [auto|human|agent|json|quiet]]hf spaces search QUERY— Search spaces on the Hub using semantic search.[--filter TEXT --sdk TEXT --include-non-running --description --limit INTEGER --format [auto|human|agent|json|quiet]]hf spaces secrets add SPACE_ID— Add or update secrets for a Space.[--secrets TEXT --secrets-file TEXT --format [auto|human|agent|json|quiet]]hf spaces secrets delete SPACE_ID KEY— Remove a secret from a Space.[--yes --format [auto|human|agent|json|quiet]]hf spaces secrets list SPACE_ID— List secrets for a Space. Secret values are write-only and not returned.[--format [auto|human|agent|json|quiet]]hf spaces settings SPACE_ID— Update the settings of a Space.[--sleep-time INTEGER --hardware [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --format [auto|human|agent|json|quiet]]hf spaces ssh SPACE_ID— SSH into a Space's Dev Mode container.[--identity-file PATH --dry-run --auto --format [auto|human|agent|json|quiet]]hf spaces templates— List the available Space templates.[--format [auto|human|agent|json|quiet]]hf spaces variables add SPACE_ID— Add or update environment variables for a Space.[--env TEXT --env-file TEXT --format [auto|human|agent|json|quiet]]hf spaces variables delete SPACE_ID KEY— Remove an environment variable from a Space.[--yes --format [auto|human|agent|json|quiet]]hf spaces variables list SPACE_ID— List environment variables for a Space.[--format [auto|human|agent|json|quiet]]hf spaces volumes delete SPACE_ID— Remove all volumes from a Space.[--yes --format [auto|human|agent|json|quiet]]hf spaces volumes list SPACE_ID— List volumes mounted in a Space.[--format [auto|human|agent|json|quiet]]hf spaces volumes set SPACE_ID— Set (replace) volumes for a Space.[--volume TEXT --format [auto|human|agent|json|quiet]]hf spaces wait SPACE_ID— Wait for a Space to finish building/starting.[--timeout TEXT --format [auto|human|agent|json|quiet]]hf spaces zero-gpu quota— Show your ZeroGPU quota (remaining GPU time and reset date).[--format [auto|human|agent|json|quiet]]
hf webhooks — Manage webhooks on the Hub.
hf webhooks create --watch TEXT— Create a new webhook.[--url TEXT --job-id TEXT --domain [repo|discussion] --secret TEXT --secrets TEXT --secrets-file TEXT --format [auto|human|agent|json|quiet]]hf webhooks delete WEBHOOK_ID— Delete a webhook permanently.[--yes --format [auto|human|agent|json|quiet]]hf webhooks disable WEBHOOK_ID— Disable an active webhook.[--format [auto|human|agent|json|quiet]]hf webhooks enable WEBHOOK_ID— Enable a disabled webhook.[--format [auto|human|agent|json|quiet]]hf webhooks info WEBHOOK_ID— Show full details for a single webhook.[--format [auto|human|agent|json|quiet]]hf webhooks list— List all webhooks for the current user.[--format [auto|human|agent|json|quiet]]hf webhooks update WEBHOOK_ID— Update an existing webhook. Only provided options are changed.[--url TEXT --job-id TEXT --watch TEXT --domain [repo|discussion] --secret TEXT --secrets TEXT --secrets-file TEXT --format [auto|human|agent|json|quiet]]
Common options
--format— Output format:--format json(or--json) or--format table(default).-q / --quiet— Quiet output (one ID per line). Equivalent to '--format quiet'.--revision— Git revision id which can be a branch name, a tag, or a commit hash.--token— Use a User Access Token. Prefer settingHF_TOKENenv var instead of passing--token.--type— The type of repository (model, dataset, space, or kernel).
Mounting repos as local filesystems
To mount Hub repositories or buckets as local filesystems — no download, no copy, no waiting — use hf-mount. Files are fetched on demand. GitHub: https://github.com/huggingface/hf-mount
Install: brew install hf-mount, or download a binary from https://github.com/huggingface/hf-mount/releases
Some command examples:
hf-mount start repo openai-community/gpt2 /tmp/gpt2— mount a repo (read-only)hf-mount start --hf-token $HF_TOKEN bucket myuser/my-bucket /tmp/data— mount a bucket (read-write)hf-mount status/hf-mount stop /tmp/data— list or unmount
Tips
- Use
hf <command> --helpfor full options, descriptions, usage, and real-world examples - Authenticate with
HF_TOKENenv var (recommended) or with--token - Update the CLI with
hf update(uses the correct command for the detected install method)