hf-cli

What it does

The skill directs the agent to use the Hugging Face Hub CLI (hf) for downloading, uploading, and managing models, datasets, spaces, buckets, repos, papers, jobs, and more on the Hugging Face Hub. It triggers when users mention 'hf', 'huggingface', 'Hugging Face', 'huggingface-cli', or related phrases, or express intent to perform Hugging Face ecosystem or AI/ML tasks. It also covers cloud storage needs like training checkpoints, data pipelines, or agent traces and notes that the hf command replaces the deprecated huggingface-cli.

How it works

• Provide installation guidance: use the command curl -LsSf https://hf.co/cli/install.sh | bash -s.
• Instruct to view available functions with hf --help, noting auth commands are under hf auth (e.g., hf auth whoami).
• List of commands includes hf cp, hf download, hf env, hf sync, hf update, hf upload, hf upload-large-folder (deprecated), hf version.
• Authentication subcommands under hf auth include list, login, logout, switch, token, whoami.
• Bucket-related commands under hf buckets include cp, create, delete, info, list, move, remove, sync.
• Cache management under hf cache with list, prune, rm, verify.
• Collections, datasets, discussions, endpoints, extensions, jobs have corresponding subcommands, such as hf collections list, hf datasets list, hf discussions list, hf endpoints list, hf extensions list, hf jobs list.
• Each command entry lists its syntax and options, e.g., hf download REPO_ID with flags like --type, --revision, --include, --exclude, etc.

When to use it

Use when the user mentions Hugging Face Hub operations, authentication needs, cache management, bucket management, running or scheduling jobs on HF infrastructure, managing HF repos, discussions/pull requests, browsing models/datasets/spaces, reading papers, managing collections, querying datasets, configuring spaces, webhooks, or HF Inference Endpoints. Also use for cloud storage like training checkpoints or agent traces. Use even if not explicitly asked for a CLI command.

What it can touch

• Commands and subcommands of the hf CLI as listed: hf cp, hf download, hf env, hf sync, hf update, hf upload, hf version, hf auth, hf buckets, hf cache, hf collections, hf datasets, hf discussions, hf endpoints, hf extensions, hf jobs.
• No external files or tools are named beyond those in the command list; quotes and exact spellings must be preserved in usage.

Caveats

• Replaces the deprecated huggingface-cli.
• Install command provided: curl -LsSf https://hf.co/cli/install.sh | bash -s.
• Mentions deprecated hf upload-large-folder as [Deprecated].
• License is Apache-2.0 (modified; see UPSTREAMS.json).