Agent skill
downloading-hf-models
Get the correct command syntax for downloading models from HuggingFace. Use when downloading models, running "hf download", or pulling models from HuggingFace repos.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/downloading-hf-models
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?