
Hf CLI
Hugging Face Hub CLI (`hf`) for downloading, uploading, and managing models, datasets, spaces, buckets, repos, papers, jobs, and more on the
- 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-skillsOr 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.
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.
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.
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-cliOr copy the folder to ~/.gemini/skills/hf-cli yourself.
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.
Get the folder:
git clone --depth 1 https://github.com/huggingface/skills.gitThen copy skills/skills/hf-cli into your agent's skills folder as hf-cli. Agents that support SKILL.md read one folder per skill.
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


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

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

Plan and coordinate the deployment of a model to Amazon SageMaker AI
- Open source
- 11.4K GitHub stars
- AI models and LLM tooling

Ensure a usable SageMaker execution role exists before deploying or training
- Open source
- 11.4K GitHub stars

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

Academy guide
SkillStop 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

Claude API
SkillReference 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

MCP builder
SkillGuide 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

Generate or edit images via OpenRouter with the Gemini 3 Pro Image model
- Open source
- 41.3K GitHub stars
- Design and media


Phoenix evals
SkillBuild and run evaluators for AI/LLM applications using Phoenix.
- Open source
- 41.3K GitHub stars
- AI models and LLM tooling



