SuperAPI AI 工具集

downloading-hf-models

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:为从 HuggingFace 下载模型提供正确的命令语法与常见错误规避说明,适用于执行 hf download 或拉取 HuggingFace 模型的场景。

主要能力与用法:推荐始终用 uv run 并以 HuggingFace Hub 包作为内联依赖,命令模式为 uv run --with huggingface_hub hf download <repo> <file> --local-dir <path>。支持下载单个文件、多个文件、使用 glob 模式(如 --include "*.gguf")、以及整个仓库。

常见错误:避免使用 pip install huggingface_hub && huggingface-cli download;避免省略 --with;避免使用 huggingface_hub[cli],该 extra 不存在,CLI 已包含在基础包中。

注意事项:大型 GGUF 模型常被拆分为多部分,应使用 --include ".gguf" 匹配单个 GGUF 与拆分部分,并先用 --dry-run 检查将下载的文件;对 GGUF 模型只下载所需量化版本而非整个仓库。HF_TOKEN 环境变量会自动用于 gated 模型;--local-dir 将文件直接放入目标目录,不产生嵌套 .cache 结构;下载可续传,重跑相同命令会跳过已下载文件。