Downloading Hf Models
Apps & Automationdownloading-hf-modelsDownloading Hf Models is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Get the correct command syntax for downloading models from HuggingFace. Use when downloading models, running "hf download", or pulling models from HuggingFace repos.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/ai-ml/downloading-hf-models/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/downloading-hf-models, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
HuggingFace Model Download
Command Pattern
Always use uv run with the HuggingFace Hub package as an inline dependency:
uv run --with huggingface_hub hf download <repo> <file> --local-dir <path>
Common Mistakes to Avoid
- Wrong:
pip install huggingface_hub && huggingface-cli download ... - Wrong:
uv run hf download ...(missing--with) - Wrong:
uv run --with "huggingface_hub[cli]" ...(the[cli]extra doesn't exist, the CLI is included in the base package)
Syntax Reference
Download a specific file
uv run --with huggingface_hub hf download <org>/<repo> <filename> --local-dir <destination>
Download multiple files
uv run --with huggingface_hub hf download <org>/<repo> <file1> <file2> --local-dir <destination>
Download with glob pattern
uv run --with huggingface_hub hf download <org>/<repo> --include "*.gguf" --local-dir <destination>
Warning: Large GGUF models are often split into parts (e.g., model.gguf.part-000, .part-001, etc.). Use --include "*.gguf*" (note the trailing *) to match both single GGUFs and split parts. Use --dry-run first to check what files will be downloaded.
Download entire repo
uv run --with huggingface_hub hf download <org>/<repo> --local-dir <destination>
Notes
HF_TOKENenvironment variable is used automatically for gated models--local-dirplaces files directly in the target directory (no nested.cachestructure)- Downloads are resumable — re-running the same command skips already-downloaded files
- For GGUF models, download only the quant you need rather than the whole repo