--- name: hugging-face-cli-c011e33ff672 description: Execute Hugging Face Hub operations using the `hf` CLI. Use when the user needs to download models/datasets/spaces, upload files to Hub repositories, create repos, manage local cache, or run compute jobs on HF infrastructure. Covers authentication, file transfers, repository creation, cache operations, and cloud compute. --- # Hugging Face CLI The `hf` CLI provides direct terminal access to the Hugging Face Hub for downloading, uploading, and managing repositories, cache, and compute resources. ## Quick Command Reference | Task | Command | |------|---------| | Login | `hf auth login` | | Download model | `hf download ` | | Download to folder | `hf download --local-dir ./path` | | Upload folder | `hf upload . .` | | Create repo | `hf repo create ` | | Create tag | `hf repo tag create ` | | Delete files | `hf repo-files delete ` | | List cache | `hf cache ls` | | Remove from cache | `hf cache rm ` | | List models | `hf models ls` | | Get model info | `hf models info ` | | List datasets | `hf datasets ls` | | Get dataset info | `hf datasets info ` | | List spaces | `hf spaces ls` | | Get space info | `hf spaces info ` | | List endpoints | `hf endpoints ls` | | Run GPU job | `hf jobs run --flavor a10g-small ` | | Environment info | `hf env` | ## Core Commands ### Authentication ```bash hf auth login # Interactive login hf auth login --token $HF_TOKEN # Non-interactive hf auth whoami # Check current user hf auth list # List stored tokens hf auth switch # Switch between tokens hf auth logout # Log out ``` ### Download ```bash hf download # Full repo to cache hf download file.safetensors # Specific file hf download --local-dir ./models # To local directory hf download --include "*.safetensors" # Filter by pattern hf download --repo-type dataset # Dataset hf download --revision v1.0 # Specific version ``` ### Upload ```bash hf upload . . # Current dir to root hf upload ./models /weights # Folder to path hf upload model.safetensors # Single file hf upload . . --repo-type dataset # Dataset hf upload . . --create-pr # Create PR hf upload . . --commit-message="msg" # Custom message ``` ### Repository Management ```bash hf repo create # Create model repo hf repo create --repo-type dataset # Create dataset hf repo create --private # Private repo hf repo create --repo-type space --space_sdk gradio # Gradio space hf repo delete # Delete repo hf repo move # Move repo to new namespace hf repo settings --private true # Update repo settings hf repo list --repo-type model # List repos hf repo branch create release-v1 # Create branch hf repo branch delete release-v1 # Delete branch hf repo tag create v1.0 # Create tag hf repo tag list # List tags hf repo tag delete v1.0 # Delete tag ``` ### Delete Files from Repo ```bash hf repo-files delete folder/ # Delete folder hf repo-files delete "*.txt" # Delete with pattern ``` ### Cache Management ```bash hf cache ls # List cached repos hf cache ls --revisions # Include individual revisions hf cache rm model/gpt2 # Remove cached repo hf cache rm # Remove cached revision hf cache prune # Remove detached revisions hf cache verify gpt2 # Verify checksums from cache ``` ### Browse Hub ```bash # Models hf models ls # List top trending models hf models ls --search "MiniMax" --author MiniMaxAI # Search models hf models ls --filter "text-generation" --limit 20 # Filter by task hf models info MiniMaxAI/MiniMax-M2.1 # Get model info # Datasets hf datasets ls # List top trending datasets hf datasets ls --search "finepdfs" --sort downloads # Search datasets hf datasets info HuggingFaceFW/finepdfs # Get dataset info # Spaces hf spaces ls # List top trending spaces hf spaces ls --filter "3d" --limit 10 # Filter by 3D modeling spaces hf spaces info enzostvs/deepsite # Get space info ``` ### Jobs (Cloud Compute) ```bash hf jobs run python:3.12 python script.py # Run on CPU hf jobs run --flavor a10g-small # Run on GPU hf jobs run --secrets HF_TOKEN # With HF token hf jobs ps # List jobs hf jobs logs # View logs hf jobs cancel # Cancel job ``` ### Inference Endpoints ```bash hf endpoints ls # List endpoints hf endpoints deploy my-endpoint \ --repo openai/gpt-oss-120b \ --framework vllm \ --accelerator gpu \ --instance-size x4 \ --instance-type nvidia-a10g \ --region us-east-1 \ --vendor aws hf endpoints describe my-endpoint # Show endpoint details hf endpoints pause my-endpoint # Pause endpoint hf endpoints resume my-endpoint # Resume endpoint hf endpoints scale-to-zero my-endpoint # Scale to zero hf endpoints delete my-endpoint --yes # Delete endpoint ``` **GPU Flavors:** `cpu-basic`, `cpu-upgrade`, `cpu-xl`, `t4-small`, `t4-medium`, `l4x1`, `l4x4`, `l40sx1`, `l40sx4`, `l40sx8`, `a10g-small`, `a10g-large`, `a10g-largex2`, `a10g-largex4`, `a100-large`, `h100`, `h100x8` ## Common Patterns ### Download and Use Model Locally ```bash # Download to local directory for deployment hf download meta-llama/Llama-3.2-1B-Instruct --local-dir ./model # Or use cache and get path MODEL_PATH=$(hf download meta-llama/Llama-3.2-1B-Instruct --quiet) ``` ### Publish Model/Dataset ```bash hf repo create my-username/my-model --private hf upload my-username/my-model ./output . --commit-message="Initial release" hf repo tag create my-username/my-model v1.0 ``` ### Sync Space with Local ```bash hf upload my-username/my-space . . --repo-type space \ --exclude="logs/*" --delete="*" --commit-message="Sync" ``` ### Check Cache Usage ```bash hf cache ls # See all cached repos and sizes hf cache rm model/gpt2 # Remove a repo from cache ``` ## Key Options - `--repo-type`: `model` (default), `dataset`, `space` - `--revision`: Branch, tag, or commit hash - `--token`: Override authentication - `--quiet`: Output only essential info (paths/URLs) ## References - **Complete command reference**: See [references/commands.md](references/commands.md) - **Workflow examples**: See [references/examples.md](references/examples.md) --- Source attribution: mashharuki Original project: https://github.com/mashharuki/Mistral-Worldwide-Hackathon/blob/c68c34d93ac91c03c85776018450ce6b9e3efb2b/.agent/skills/hugging-face-cli/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Haruki Kondo Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: mashharuki Original project: https://github.com/mashharuki/Mistral-Worldwide-Hackathon/blob/c68c34d93ac91c03c85776018450ce6b9e3efb2b/.agent/skills/hugging-face-cli/SKILL.md Attribution basis: Source repository record Fields of work: Data & Analytics, Development & Engineering Roles: Data Engineer, Data Scientist, ML / AI Engineer Specialties: API Tools: Hugging Face Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 3ccab8e0c1041a323c97efd90afff88d3913fc514cdfaf9e07d4e69d79051533