CLI Profile

Hugging Face CLI

Community CuratedHugging Facevlatest

Download/upload models and datasets from Hugging Face Hub.

Install Matrix

pip

hash: unavailable

Auth Guide

API Keyreadwrite

Token refresh: Rotate Hugging Face access token in account settings.

Step 1

Export required environment variables: HF_TOKEN

Command Map

Global Flags

--help (string|boolean) - show this help message and exit

Ai Inference

huggingface-cli download

Download files from the Hub

Output: Tableai-inferencedeveloper-loop

--force-downloadoptional (string|boolean) - If True, the files will be downloaded even if they are
--resume-downloadoptional (string|boolean) - Deprecated and ignored. Downloading a file to local
--quietoptional (string|boolean) - If True, progress bars are disabled and only the path

Example 1

Example 2

Known errors: Model access denied; Inference job failed; Provider quota exceeded

huggingface-cli upload

Upload a file or a folder to a repo on the Hub

Output: Plain textai-inferencedeveloper-loop

--privateoptional (string|boolean) - Whether to create a private repo if repo doesn't exist
--create-proptional (string|boolean) - Whether to upload content as a new Pull Request.
--quietoptional (string|boolean) - If True, progress bars are disabled and only the path

Example 1

Example 2

Known errors: Model access denied; Project or environment not linked; Build/deploy operation failed on remote provider

huggingface-cli repo-files

Manage files in a repo on the Hub

Output: Tableai-inferencedeveloper-loop

Example 1

Example 2

Known errors: Model access denied; Inference job failed; Provider quota exceeded

huggingface-cli env

Print information about the environment.

Output: Tableai-inferencedeveloper-loop

Example 1

Example 2

Known errors: Model access denied; Inference job failed; Provider quota exceeded

huggingface-cli login

Output: Plain textai-inferencedeveloper-loop

Example 1

Example 2

Known errors: Model access denied; Login flow interrupted; Token expired or missing scope

huggingface-cli whoami

Find out which huggingface.co account you are logged

Output: Tableai-inferencedeveloper-loop

Example 1

Example 2

Known errors: Model access denied; Login flow interrupted; Token expired or missing scope

huggingface-cli logout

Log out

Output: Tableai-inferencedeveloper-loop

Example 1

Example 2

Known errors: Model access denied; Inference job failed; Provider quota exceeded

Workflow Recipes

AI Inference

Authenticate model providers and execute inference runs.

1ollama

→

2huggingface-cli

→

3replicate

Open workflow detail

Compatibility

Claude CodeUntestedEstimatedCodex CLIUntestedEstimatedGemini CLIUntestedEstimatedClineUntestedEstimatedAiderUntestedEstimatedOpenCodeUntestedEstimated

Requirements

Runtime: Standalone binary / package-managed CLI
Platforms: macOS, Linux (arm64, x86_64)
Approx. Size (estimated): ~32 MB

Permissions

Network: Yes
Filesystem: Read/Write
Credentials: HF_TOKEN
Ports: Not declared

Safe Execution

This CLI has broad system access. Recommended: run inside a container/sandbox.

Listing Stats

Queries/Week: 82.2
Trust Score: 81.0
Last Verified: 2/17/2026, 6:51:51 PM
Last Updated: 2/17/2026, 6:51:51 PM
Website: https://huggingface.co/docs/huggingface_hub/main/en/guides/cli

Version Feed

Version: #1
ID: lv_huggingface-cli_1
Updated: 2/17/2026, 6:51:51 PM
Changes: commands, auth, install

Report Issue

CLI Profile

Loading CLI profile...

Fetching install matrix, auth flow, command map, and compatibility data.

Please wait while clime prepares the listing details.