hf-cli

Manage Hugging Face Hub repositories, models, datasets, and Spaces via the hf CLI.

1|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/BlackRoad-OS-Inc/blackroad-operator --skill hf-cli-blackroad-os-inc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hf-cli
Source: https://github.com/BlackRoad-OS-Inc/blackroad-operator/tree/main/agents/skills/skills/hf-cli
Command: npx skills add https://github.com/BlackRoad-OS-Inc/blackroad-operator --skill hf-cli-blackroad-os-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hugging Face Hub users often juggle repos, models, datasets, and Spaces across multiple tools. The hf-cli consolidates these tasks into a single, consistent command-line interface, reducing context switching and errors.

Core Features & Use Cases

  • Download: Retrieve files from a Hub repo to a local workspace.
  • Upload: Push local changes to a Hub repo, including models and datasets.
  • Authentication & Environment: Manage access tokens and environment configuration for secure operations.
  • Workflow Integration: Integrate hf into CI/CD and data science workflows for reproducible results.

Quick Start

Install the hf CLI and begin managing your Hugging Face Hub assets from the terminal.

Frequently Asked Questions about hf-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Hugging Face Hub assets from the command line?▼

Manage Hugging Face Hub assets from the command line by using the hf CLI to clone repositories, upload models, sync datasets, and publish Spaces. It consolidates these tasks into a single interface to reduce context switching.

What is the best way to upload models and sync datasets to Hugging Face?▼

The best way to upload models and sync datasets to Hugging Face is using the hf CLI. It pushes local changes directly to a Hub repo, providing a robust and repeatable workflow for development pipelines.

How do I configure authentication tokens for Hugging Face CLI operations?▼

Configure authentication tokens for Hugging Face CLI operations using the built-in access token management commands. This manages your environment configuration to ensure secure operations when pushing or pulling Hub assets.

Can I integrate Hugging Face CLI commands into CI/CD pipelines?▼

Yes, you can integrate Hugging Face CLI commands into CI/CD pipelines. The hf CLI supports workflow integration for data science and development pipelines, ensuring reproducible results when downloading or publishing assets.

How do I download files from a Hugging Face repo to my local workspace?▼

Download files from a Hugging Face repo to your local workspace using the standard hf CLI download commands. This retrieves repository contents directly to your local environment for development.

Why use a dedicated CLI for Hugging Face repositories instead of multiple tools?▼

Use a dedicated CLI for Hugging Face repositories to avoid juggling multiple tools. The hf-cli provides a consistent command-line interface that reduces errors and context switching when managing models, datasets, and Spaces.