Hugging Face CLI

---
name: hf-cli
description: Hugging Face Hub CLI (hf) for downloading, uploading, and managing repositories, models, datasets, and Spaces on the Hugging Face Hub. Replaces deprecated huggingface-cli command.
---

The Hugging Face Hub CLI tool `hf` is available. IMPORTANT: The `hf` command replaces the deprecated `huggingface-cli` command.

Use `hf --help` to view available functions. Note that auth commands are now all under `hf auth` e.g. `hf auth whoami`.

## Installation

Download the install script from https://hf.co/cli and review before running.

## Commands

- `hf download REPO_ID` — Download files from the Hub.
- `hf env` — Print information about the environment.
- `hf sync` — Sync files between local directory and a bucket.
- `hf upload REPO_ID` — Upload a file or a folder to the Hub.
- `hf upload-large-folder REPO_ID LOCAL_PATH` — Upload a large folder.
- `hf version` — Print version info.

### hf auth — Manage authentication

- `hf auth list` — List stored access tokens.
- `hf auth login` — Login using token.
- `hf auth logout` — Logout.
- `hf auth switch` — Switch between tokens.
- `hf auth whoami` — Check current account.

### hf repos — Manage repos

- `hf repos create REPO_ID` — Create a new repo.
- `hf repos delete REPO_ID` — Delete a repo.
- `hf repos duplicate FROM_ID` — Duplicate a repo.
- `hf repos move FROM_ID TO_ID` — Move a repository.

### hf models — Model operations

- `hf models info MODEL_ID` — Get model info.
- `hf models list` — List models.

### hf datasets — Dataset operations

- `hf datasets info DATASET_ID` — Get dataset info.
- `hf datasets list` — List datasets.
- `hf datasets sql SQL` — Execute SQL with DuckDB.

### hf spaces — Spaces operations

- `hf spaces info SPACE_ID` — Get Space info.
- `hf spaces list` — List Spaces.
- `hf spaces dev-mode SPACE_ID` — Enable/disable dev mode.

### hf jobs — Run compute jobs

- `hf jobs run IMAGE COMMAND` — Run a Job.
- `hf jobs ps` — List Jobs.
- `hf jobs logs JOB_ID` — Fetch logs.
- `hf jobs cancel JOB_ID` — Cancel a Job.

### hf endpoints — Inference Endpoints

- `hf endpoints deploy NAME repo framework accelerator instance_size region` — Deploy.
- `hf endpoints list` — List endpoints.
- `hf endpoints delete NAME` — Delete.
- `hf endpoints pause NAME` — Pause.

### hf collections — Collections

- `hf collections create TITLE` — Create collection.
- `hf collections add-item COLLECTION_SLUG ITEM_ID ITEM_TYPE` — Add item.
- `hf collections list` — List collections.

### Other commands

- `hf buckets` — Manage storage buckets.
- `hf cache` — Manage local cache.
- `hf discussions` — Manage PRs.
- `hf papers` — List papers.
- `hf webhooks` — Manage webhooks.
- `hf extensions` — Manage CLI extensions.

## Tips

- Use `hf <command> --help` for full options
- Use `--format json` for machine-readable output
- Use `-q` to print only IDs
- Authenticate with `HF_TOKEN` env var

---

Source: huggingface/skills repo