Hugging Face CLI (`hf`) Reference Guide
HuggingFace hf CLI: search/download/upload models, datasets.
MCP get_skill({ skillId: "hugging-face-cli-hf-reference-guide-0c7f83f6" })Use this skill with your agent
Create a free account and connect via MCP
# Hugging Face CLI (`hf`) Reference Guide The `hf` command is the modern command-line interface for interacting with the Hugging Face Hub, providing tools to manage repositories, models, datasets, and Spaces. > **IMPORTANT:** The `hf` command replaces the now deprecated `huggingface-cli` command. ## Quick Start * **Installation:** `curl -LsSf https://hf.co/cli/install.sh | bash -s` * **Help:** Use `hf --help` to view all available functions and real-world examples. * **Authentication:** Recommended via `HF_TOKEN` environment variable or the `--token` flag. --- ## Core Commands ### General Operations * `hf download REPO_ID`: Download files from the Hub. * `hf upload REPO_ID`: Upload files/folders (recommended for single-commit). * `hf upload-large-folder REPO_ID LOCAL_PATH`: Recommended for resumable uploads of large directories. * `hf sync`: Sync files between a local directory and a bucket. * `hf env` / `hf version`: View environment and version details. ### Authentication (`hf auth`) * `login` / `logout`: Manage sessions using tokens from [huggingface.co/settings/tokens](https://huggingface.co/settings/tokens). * `list` / `switch`: Manage and toggle between multiple stored access tokens. * `whoami`: Identify the currently logged-in account. ### Repository Management (`hf repos`) * `create` / `delete`: Create or permanently remove repositories. * `duplicate`: Clone a model, dataset, or Space to a new ID. * `move`: Transfer a repository between namespaces. * `branch` / `tag`: Manage Git-like references. * `delete-files`: Remove specific files using patterns. --- ## Specialized Hub Interactions ### Datasets & Models * **Datasets:** `hf datasets list`, `info`, and `parquet` (list parquet URLs). * **SQL Queries:** `hf datasets sql SQL` — Execute raw SQL via DuckDB against dataset parquet URLs. * **Models:** `hf models list` and `info`. * **Papers:** `hf papers list` — View daily papers. ### Discussions & Pull Requests (`hf discussions`) * Manage the lifecycle of Hub contributions: `list`, `create`, `info`, `comment`, `close`, `reopen`, and `rename`. * `diff`: View changes in a PR. * `merge`: Finalize pull requests. ### Infrastructure & Compute * **Endpoints:** Deploy and manage Inference Endpoints (`deploy`, `pause`, `resume`, `scale-to-zero`, `catalog`). * **Jobs:** Run compute tasks on HF infrastructure. Includes `hf jobs uv` for running Python scripts with inline dependencies and `stats` for resource monitoring. * **Spaces:** Manage interactive apps. Includes `dev-mode` and `hot-reload` for Python files without full restarts. ### Storage & Automation * **Buckets:** Full S3-like bucket management (`create`, `cp`, `mv`, `rm`, `sync`). * **Cache:** Manage local storage with `list`, `prune` (remove detached revisions), and `verify` (checksum checks). * **Webhooks:** Automate workflows by managing Hub webhooks (`create`, `watch`, `enable`/`disable`). * **Collections:** Organize Hub items into collections (`add-item`, `update`, `list`). --- ## Advanced Usage & Tips ### Global Flags * `--format json`: Produces machine-readable output for automation. * `-q` / `--quiet`: Limits output to IDs only. ### Extensions & Skills * **Extensions:** Extend CLI functionality via GitHub repositories using `hf extensions install REPO_ID`. * **Skills:** Manage AI assistant skills with `hf skills add`.
Related Skills
More skills in Data, AI & Research
Ablation Planner
Use when main results pass result-to-claim (`claim_supported = yes` or `partial`) and ablation studies are needed for paper submission. A secondary Codex agent designs ablations from a reviewer's perspective; the local executor reviews feasibility and implements.
Ablation Planner
Use when main results pass result-to-claim (claim_supported=yes or partial) and ablation studies are needed for paper submission.
About
Provides information about the bitwize-music plugin, its version, and its creator. Use when the user asks about the plugin, its purpose, version, or capabilities.
Ab Test Analysis
Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop recommendations. Use when evaluating experiment results, checking if a test reached significance, interpreting split test data, or deciding whether to ship a variant.
Academic Search
Search and analyze academic literature. Find papers, understand research methodologies, and synthesize academic findings for research projects.
Adaptyv
How to use the Adaptyv Bio Foundry API and Python SDK for protein experiment design, submission, and results retrieval. Use this skill whenever the user mentions Adaptyv, Foundry API, protein binding assays, protein screening experiments, BLI/SPR assays, thermostability assays, or wants to submit protein sequences for experimental characterization. Also trigger when code imports `adaptyv`, `adaptyv_sdk`, or `FoundryClient`, or references `foundry-api-public.adaptyvbio.com`.
Explore Other Categories
Skills from other categories with shared topics
Blackbox CLI
Delegate coding tasks to Blackbox AI CLI agent. Multi-model agent with built-in judge that runs tasks through multiple LLMs and picks the best result. Requires the blackbox CLI and a Blackbox AI API key.
Creative Ideation
Generate project ideas via creative constraints.
Debugging Hermes TUI Slash Commands
Debug Hermes TUI slash commands: Python, gateway, Ink UI.