Hugging Face CLI

---

source: "https://github.com/huggingface/skills/tree/main/skills/hf-cli" name: hugging-face-cli description: "使用 Hugging Face Hub CLI (hf) 下载、上传和管理模型、数据集和 Spaces。" risk: unknown

通过先下载安装脚本、审查后再本地运行来安装。示例： curl -LsSf https://hf.co/cli/install.sh -o /tmp/hf-install.sh && less /tmp/hf-install.sh && bash /tmp/hf-install.sh

何时使用

当你需要 hf CLI 进行 Hub 认证、下载、上传、仓库管理或基本计算操作时使用此技能。

Hugging Face Hub CLI 工具 hf 可用。重要：hf 命令替代了已弃用的 huggingface-cli 命令。

使用 hf --help 查看可用功能。注意认证命令现在都在 hf auth 下，例如 hf auth whoami。

使用 huggingface_hub v1.8.0 生成。运行 hf skills add --force 重新生成。

命令

• hf download REPO_ID — 从 Hub 下载文件。[--type CHOICE --revision TEXT --include TEXT --exclude TEXT --cache-dir TEXT --local-dir TEXT --force-download --dry-run --quiet --max-workers INTEGER]
• hf env — 打印环境信息。
• hf sync — 在本地目录和 bucket 之间同步文件。[--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --quiet]
• hf upload REPO_ID — 上传文件或文件夹到 Hub。推荐用于单次提交上传。[--type CHOICE --revision TEXT --private --include TEXT --exclude TEXT --delete TEXT --commit-message TEXT --commit-description TEXT --create-pr --every FLOAT --quiet]
• hf upload-large-folder REPO_ID LOCAL_PATH — 上传大文件夹到 Hub。推荐用于可恢复上传。[--type CHOICE --revision TEXT --private --include TEXT --exclude TEXT --num-workers INTEGER --no-report --no-bars]
• hf version — 打印 hf 版本信息。

hf auth — 管理认证（登录、登出等）。

• hf auth list — 列出所有存储的访问令牌。
• hf auth login — 使用 huggingface.co/settings/tokens 的令牌登录。[--add-to-git-credential --force]
• hf auth logout — 从特定令牌登出。[--token-name TEXT]
• hf auth switch — 在访问令牌之间切换。[--token-name TEXT --add-to-git-credential]
• hf auth whoami — 查看当前登录的 huggingface.co 账户。[--format CHOICE]

hf buckets — 与 bucket 交互的命令。

• hf buckets cp SRC — 复制单个文件到 bucket 或从 bucket 复制。[--quiet]
• hf buckets create BUCKET_ID — 创建新 bucket。[--private --exist-ok --quiet]
• hf buckets delete BUCKET_ID — 删除 bucket。[--yes --missing-ok --quiet]
• hf buckets info BUCKET_ID — 获取 bucket 信息。[--quiet]
• hf buckets list — 列出 bucket 或 bucket 中的文件。[--human-readable --tree --recursive --format CHOICE --quiet]
• hf buckets move FROM_ID TO_ID — 移动（重命名）bucket 到新名称或命名空间。
• hf buckets remove ARGUMENT — 从 bucket 中删除文件。[--recursive --yes --dry-run --include TEXT --exclude TEXT --quiet]
• hf buckets sync — 在本地目录和 bucket 之间同步文件。[--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --quiet]

hf cache — 管理本地缓存目录。

• hf cache list — 列出缓存的仓库或修订版本。[--cache-dir TEXT --revisions --filter TEXT --format CHOICE --quiet --sort CHOICE --limit INTEGER]
• hf cache prune — 从缓存中删除分离的修订版本。[--cache-dir TEXT --yes --dry-run]
• hf cache rm TARGETS — 删除缓存的仓库或修订版本。[--cache-dir TEXT --yes --dry-run]
• hf cache verify REPO_ID — 验证缓存或本地目录中单个仓库修订版本的校验和。[--type CHOICE --revision TEXT --cache-dir TEXT --local-dir TEXT --fail-on-missing-files --fail-on-extra-files]

hf collections — 与 Hub 上的集合交互。

• hf collections add-item COLLECTION_SLUG ITEM_ID ITEM_TYPE — 向集合添加项目。[--note TEXT --exists-ok]
• hf collections create TITLE — 在 Hub 上创建新集合。[--namespace TEXT --description TEXT --private --exists-ok]
• hf collections delete COLLECTION_SLUG — 从 Hub 删除集合。[--missing-ok]
• hf collections info COLLECTION_SLUG — 获取 Hub 上集合的信息。输出为 JSON 格式。
• hf collections list — 列出 Hub 上的集合。[--owner TEXT --item TEXT --sort CHOICE --limit INTEGER --format CHOICE --quiet]

限制

• 仅在任务明确匹配上述描述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。