Hf

Hugging Face CLI

Use hf for Hub operations from the shell. The CLI generates its own command skill from the installed version; this skill owns authentication, cache hygiene, and the authority boundary around uploads and paid jobs.

Workflow

1. Resolve the account: hf auth whoami; log in with hf auth login or pass HF_TOKEN through the environment. Never run hf auth token in a transcript or log.
2. Read before writing: hf models info , hf models card , hf models ls --sort downloads --limit 10, and the datasets and spaces twins answer most questions without a download.
3. Download into an ignored directory: gated repositories need the license accepted on the website first.

``bash hf download --local-dir models/ hf download / --repo-type dataset --local-dir data/ ``

1. Keep the cache under control: hf cache ls, hf cache prune, hf cache rm ; HF_HOME relocates it.
2. Upload with authority: hf repos create --private then hf upload ; confirm repository, visibility, and license before the first push, then verify with hf models info or hf repos ls.
3. Remote compute with authority: hf jobs run and hf jobs uv run bill by hardware flavor; confirm the flavor and timeout, then watch hf jobs logs and hf jobs ps.

Gotchas

• Name: hf replaced huggingface-cli; the mise tool is pipx:huggingface_hub.
• Large transfers: hf download and hf upload resume; hf cache verify checks checksums after an interrupted run.
• Pin a revision: pass --revision for reproducible downloads; anything loaded with trust_remote_code is third-party code to review first.

Official Skills

Upstream: huggingface/skills, the same packages the CLI marketplace serves. The hf-native commands below replace the default installer while preserving the review and project-scope rules in the shared [vendor-skill policy](../agent-project/references/vendor-skills.md):

hf skills list
hf skills add                  # the CLI skill into .agents/skills
hf skills add 
hf skills update

Documentation

• hf CLI guide · huggingface/skills
• Releases: huggingface_hub
• Companion skills: [kaggle](../kaggle/SKILL.md), [colab](../colab/SKILL.md), [python-stack](../python-stack/references/foundation/GUIDE.md).

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: fmind
• Source: fmind/dot
• License: MIT
• Homepage: https://fmind.dev

Install and usage instructions live in the source repository linked above.