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.