# hf-cli

> Claude/Codex skill by [@huggingface](https://omgskills.com/library/huggingface/index.md) · 11k stars · Updated 2026-10-23

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\`.

## Install

```sh
git clone https://github.com/huggingface/skills /tmp/skills && ln -s /tmp/skills/skills/hf-cli ~/.claude/skills/hf-cli
```

## From README

Commands hf cp SRC — Copy files between local paths, repositories, and buckets. \[--format \[auto|human|agent|json|quiet\]\] hf download REPOID — Download files from the Hub. \[--type \[model|dataset|space|kernel\] --revision TEXT --include TEXT --exclude TEXT --cache-dir TEXT --local-dir TEXT --force-download --dry-run --max-workers INTEGER --format \[auto|human|agent|json|quiet\]\] hf env — Print information about the environment. \[--format \[auto|human|agent|json|quiet\]\] hf sync — Sync files between local directory and a bucket. \[--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --format \[auto|human|agent|json|quiet\]\] hf update — Update the hf CLI to the latest version. \[--format \[auto|human|agent|json|quiet\]\] hf upload REPOID — Upload a file or a folder to the Hub.

## Links

- HTML page: https://omgskills.com/library/huggingface/skills/hf-cli/
- GitHub: https://github.com/huggingface/skills
- Author: [@huggingface](https://omgskills.com/library/huggingface/index.md)

## More from this repo

- [hf-mcp](https://omgskills.com/library/huggingface/skills/hf-mcp/index.md) — Use Hugging Face Hub via MCP server tools.
   - [@huggingface](https://omgskills.com/library/huggingface/index.md) · 11k stars
- [huggingface-best](https://omgskills.com/library/huggingface/skills/huggingface-best/index.md) — Used when the user asks about finding the best, top, or recommended model for a task, wants to know what AI model to...
   - [@huggingface](https://omgskills.com/library/huggingface/index.md) · 11k stars
- [huggingface-community-evals](https://omgskills.com/library/huggingface/skills/huggingface-community-evals/index.md) — Used to run evaluations for Hugging Face Hub models using inspect-ai and lighteval on local hardware.
   - [@huggingface](https://omgskills.com/library/huggingface/index.md) · 11k stars