huggingface-hub

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

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill huggingface-hub-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: huggingface-hub
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/mlops/models/huggingface-hub
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill huggingface-hub-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the Hugging Face Hub through the web UI or raw API calls is slow and hard to automate. This Skill provides a complete reference for the modern hf command-line interface, replacing the deprecated huggingface-cli, so you can script and automate Hub operations directly from the terminal. ## Core Features & Use Cases - Model & Dataset Operations: Search, download, and upload models and datasets, including resumable uploads of large directories and SQL queries against dataset parquet files via DuckDB. - Repository & Collaboration Management: Create, duplicate, move, and delete repositories, manage branches and tags, and handle discussions and pull requests end to end. - Infrastructure & Automation: Deploy Inference Endpoints, run compute Jobs, manage Spaces, S3-like buckets, caches, webhooks, and collections. - Use Case: You need to download a fine-tuned model, query a dataset with SQL, and deploy it to an Inference Endpoint. Use this Skill to run hf download, hf datasets sql, and endpoint deployment commands in one automated workflow. ## Quick Start Ask the agent to use the hf CLI to download a specific model from the Hugging Face Hub and show its repository info.

Frequently Asked Questions about huggingface-hub

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

FAQPage Schema
How do I download a model from Hugging Face Hub using the CLI?▼

Use `hf download REPO_ID` to download files from the Hub. Authenticate first with the HF_TOKEN environment variable or the --token flag, and add --format json for machine-readable output in automation scripts.

How to upload large folders to Hugging Face Hub?▼

Use `hf upload REPO_ID LOCAL_PATH`, which handles single-commit uploads and resumable uploads of large directories. The older `hf upload-large-folder` command is deprecated and should no longer be used.

What is the difference between hf and huggingface-cli?▼

The `hf` command is the modern CLI for the Hugging Face Hub and fully replaces the deprecated `huggingface-cli` command. All new workflows should use `hf`, which adds features like datasets SQL, jobs, buckets, and webhooks.

Can I run SQL queries on Hugging Face datasets?▼

Yes, `hf datasets sql SQL` executes raw SQL via DuckDB directly against dataset parquet URLs. You can also list parquet URLs with `hf datasets parquet` before querying.

How do I authenticate the Hugging Face CLI with multiple tokens?▼

Run `hf auth login` with a token from huggingface.co/settings/tokens, or set the HF_TOKEN environment variable. Use `hf auth list` and `hf auth switch` to manage and toggle between multiple stored tokens.

Does the hf CLI work on Windows, Linux, and macOS?▼

Yes, the hf CLI supports Linux, macOS, and Windows. Install it with the official install script from hf.co/cli/install.sh, then verify your setup with `hf env` or `hf version`.