Skip to content
Skill

Hf CLI

Hugging Face Hub CLI (`hf`) for downloading, uploading, and managing models, datasets, spaces, buckets, repos, papers, jobs, and more on the

Install
Scripts
None
Platforms
Claude Code, Codex, Cursor
GitHub stars
11.4K
Last commit
4 days ago
License
Apache-2.0
Listing updated
today

When your agent uses it

Hugging Face Hub CLI (`hf`) for downloading, uploading, and managing models, datasets, spaces, buckets, repos, papers, jobs, and more on the Hugging Face Hub. Use when: handling authentication; managing local cache; managing Hugging Face Buckets; running or scheduling jobs on Hugging Face infrastructure; managing Hugging Face repos; discussions and pull requests; browsing models, datasets and spaces; reading, searching, or browsing academic papers; managing collections; querying datasets; configuring spaces; setting up webhooks; or deploying and managing HF Inference Endpoints. Make sure to use this skill whenever the user mentions 'hf', 'huggingface', 'Hugging Face', 'huggingface-cli', or 'hugging face cli', or wants to do anything related to the Hugging Face ecosystem and to AI and ML in general. Also use for cloud storage needs like training checkpoints, data pipelines, or agent traces. Use even if the user doesn't explicitly ask for a CLI command. Replaces the deprecated `huggingface-cli`.

From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.

What it can access

From a static check of its 1 file (33 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.

Install

This skill ships in the hf-cli plugin. In Claude Code, add the marketplace and install the plugin (it may include other skills too):

/plugin marketplace add huggingface/skills
/plugin install hf-cli@huggingface-skills

Or copy only this skill to ~/.claude/skills/hf-cli:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/hf-cli &&
cp -R "$tmp/skills/hf-cli" ~/.claude/skills/hf-cli &&
rm -rf "$tmp"

For one project only, put the folder in .claude/skills/hf-cli inside it instead.

Claude Code docs on skills

Copy the skill folder to ~/.agents/skills/hf-cli to use it in every repository:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/hf-cli &&
cp -R "$tmp/skills/hf-cli" ~/.agents/skills/hf-cli &&
rm -rf "$tmp"

For one repository only, put the folder in .agents/skills/hf-cli inside it instead.

Codex docs on skills

Copy the skill folder to ~/.cursor/skills/hf-cli to use it in every project:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/hf-cli &&
cp -R "$tmp/skills/hf-cli" ~/.cursor/skills/hf-cli &&
rm -rf "$tmp"

For one project only, put the folder in .cursor/skills/hf-cli inside it instead.

Cursor docs on skills

Run in a terminal (add --scope workspace to install it for the current workspace only):

gemini skills install https://github.com/huggingface/skills.git --path skills/hf-cli

Or copy the folder to ~/.gemini/skills/hf-cli yourself.

Gemini CLI docs on skills

For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/hf-cli:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/hf-cli &&
cp -R "$tmp/skills/hf-cli" ~/.copilot/skills/hf-cli &&
rm -rf "$tmp"

For one project only, put the folder in .github/skills/hf-cli inside it instead.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/huggingface/skills.git

Then copy skills/skills/hf-cli into your agent's skills folder as hf-cli. Agents that support SKILL.md read one folder per skill.

The SKILL.md format

Hf CLI FAQ

How do I install Hf CLI in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/hf-cli to use it in all your projects, or to .claude/skills/hf-cli in one project. Or install the hf-cli plugin, which includes it: /plugin marketplace add huggingface/skills, then /plugin install hf-cli@huggingface-skills.

Does Hf CLI run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

Which AI agents can use Hf CLI?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

What are the best alternatives to Hf CLI?

The closest alternatives to Hf CLI are Academy guide, Claude API, MCP builder, Nano banana pro openrouter and Generate image.

More from huggingface/skills

  1. Use Hugging Face Hub via MCP server tools

    • Open source
    • 11.4K GitHub stars
  2. Discover the user's local AWS context (active profile, region, account ID, caller identity) at the start of any AWS task

    • Open source
    • 11.4K GitHub stars
    • Cloud and infrastructure
  3. Set up an isolated Python environment for SageMaker / AWS work, with the right Python version and current boto3

    • Open source
    • 11.4K GitHub stars
  4. Create a SageMaker endpoint (real-time, real-time scale-to-zero, or async) with autoscaling, CloudWatch alarms, and tagging enabled by defau

    • Open source
    • 11.4K GitHub stars

Alternatives to Hf CLI

  1. Stop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching cour

    • 196K GitHub stars
    • AI models and LLM tooling
  2. Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model

    • 196K GitHub stars
    • AI models and LLM tooling
  3. Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-design

    • 196K GitHub stars
    • AI models and LLM tooling
  4. Generate or edit images via OpenRouter with the Gemini 3 Pro Image model

    • Open source
    • 41.3K GitHub stars
    • Design and media
  5. Generate images using AI

    • Open source
    • 41.3K GitHub stars
    • Design and media
  6. Build and run evaluators for AI/LLM applications using Phoenix.

    • Open source
    • 41.3K GitHub stars
    • AI models and LLM tooling