---
name: hf-cli
description: "Hugging Face Hub CLI (`hf`) 用于在 Hugging Face Hub 上下载、上传和管理模型、数据集、spaces、存储桶、仓库、论文、作业等。当需要：处理认证；管理本地缓存；管理 Hugging Face 存储桶；在 Hugging Face 基础设施上运行或调度作业；管理 Hugging Face 仓库；讨论和拉取请求；浏览模型、数据集和 spaces；阅读、搜索或浏览学术论文；管理集合；查询数据集；配置 spaces；设置 webhook；或部署和管理 HF 推理端点时使用。当用户提到 'hf'、'huggingface'、'Hugging Face'、'huggingface-cli' 或 'hugging face cli'，或想要做任何与 Hugging Face 生态系统以及一般 AI 和 ML 相关的事情时，确保使用此技能。也用于云存储需求，如训练检查点、数据管道或代理跟踪。即使用户没有明确要求 CLI 命令，也要使用。替代现已弃用的 `huggingface-cli`。"
---

安装：`curl -LsSf https://hf.co/cli/install.sh | bash -s`。

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

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

由 `huggingface_hub v1.23.0` 生成。运行 `hf skills add --force` 重新生成。

## 命令

- `hf cp SRC` — 在本地路径、仓库和存储桶之间复制文件。`[--format [auto|human|agent|json|quiet]]`
- `hf download REPO_ID` — 从 Hub 下载文件。`[--type [model|dataset|space] --revision TEXT --include TEXT --exclude TEXT --cache-dir TEXT --local-dir TEXT --force-download --dry-run --max-workers INTEGER --format [auto|human|agent|json|quiet]]`
- `hf env` — 打印环境信息。`[--format [auto|human|agent|json|quiet]]`
- `hf sync` — 在本地目录和存储桶之间同步文件。`[--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --format [auto|human|agent|json|quiet]]`
- `hf update` — 更新 `hf` CLI 到最新版本。`[--format [auto|human|agent|json|quiet]]`
- `hf upload REPO_ID` — 上传文件或文件夹到 Hub。推荐用于单次提交上传。`[--type [model|dataset|space] --revision TEXT --private --include TEXT --exclude TEXT --delete TEXT --commit-message TEXT --commit-description TEXT --create-pr --every FLOAT --format [auto|human|agent|json|quiet]]`
- `hf upload-large-folder REPO_ID LOCAL_PATH` — [已弃用] 上传大文件夹到 Hub。请改用 `hf upload`。`[--type [model|dataset|space] --revision TEXT --private --include TEXT --exclude TEXT --num-workers INTEGER --no-report --no-bars --format [auto|human|agent|json|quiet]]`
- `hf version` — 打印 hf 版本信息。`[--format [auto|human|agent|json|quiet]]`

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

- `hf auth list` — 列出所有存储的访问令牌。`[--format [auto|human|agent|json|quiet]]`
- `hf auth login` — 从浏览器登录，或使用来自 huggingface.co/settings/tokens 的令牌登录。`[--add-to-git-credential --force --format [auto|human|agent|json|quiet]]`
- `hf auth logout` — 从特定令牌登出。`[--token-name TEXT --format [auto|human|agent|json|quiet]]`
- `hf auth switch` — 在访问令牌之间切换。`[--token-name TEXT --add-to-git-credential --format [auto|human|agent|json|quiet]]`
- `hf auth token` — 将当前访问令牌打印到 stdout。`[--format [auto|human|agent|json|quiet]]`
- `hf auth whoami` — 找出您登录的 huggingface.co 账户。`[--format [auto|human|agent|json|quiet]]`

### `hf buckets` — 与存储桶交互的命令。

- `hf buckets cp SRC` — 在本地路径、仓库和存储桶之间复制文件。`[--format [auto|human|agent|json|quiet]]`
- `hf buckets create BUCKET_ID` — 创建新存储桶。`[--private --region [us|eu] --exist-ok --format [auto|human|agent|json|quiet]]`
- `hf buckets delete BUCKET_ID` — 删除存储桶。`[--yes --missing-ok --format [auto|human|agent|json|quiet]]`
- `hf buckets info BUCKET_ID` — 获取存储桶信息。`[--format [auto|human|agent|json|quiet]]`
- `hf buckets list` — 列出存储桶或存储桶中的文件。`[--human-readable --tree --recursive --search TEXT --format [auto|human|agent|json|quiet]]`
- `hf buckets move FROM_ID TO_ID` — 将存储桶移动（重命名）到新名称或命名空间。`[--format [auto|human|agent|json|quiet]]`
- `hf buckets remove ARGUMENT` — 从存储桶中删除文件。`[--recursive --yes --dry-run --include TEXT --exclude TEXT --format [auto|human|agent|json|quiet]]`
- `hf buckets sync` — 在本地目录和存储桶之间同步文件。`[--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --format [auto|human|agent|json|quiet]]`

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

- `hf cache list` — 列出缓存的仓库或修订版。`[--cache-dir TEXT --revisions --filter TEXT --sort [accessed|accessed:asc|accessed:desc|modified|modified:asc|modified:desc|name|name:asc|name:desc|size|size:asc|size:desc] --limit INTEGER --format [auto|human|agent|json|quiet]]`
- `hf cache prune` — 从缓存中删除分离的修订版和未完成的下载。`[--cache-dir TEXT --yes --dry-run --format [auto|human|agent|json|quiet]]`
- `hf cache rm TARGETS` — 删除缓存的仓库或修订版。`[--cache-dir TEXT --yes --dry-run --format [auto|human|agent|json|quiet]]`
- `hf cache verify REPO_ID` — 验证来自缓存或本地目录的单个仓库修订版的校验和。`[--type [model|dataset|space] --revision TEXT --cache-dir TEXT --local-dir TEXT --fail-on-missing-files --fail-on-extra-files --format [auto|human|agent|json|quiet]]`

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

- `hf collections add-item COLLECTION_SLUG ITEM_ID ITEM_TYPE` — 向集合添加项目。`[--note TEXT --exists-ok --format [auto|human|agent|json|quiet]]`
- `hf collections create TITLE` — 在 Hub 上创建新集合。`[--namespace TEXT --description TEXT --private --exists-ok --format [auto|human|agent|json|quiet]]`
- `hf collections delete COLLECTION_SLUG` — 从 Hub 中删除集合。`[--missing-ok --format [auto|human|agent|json|quiet]]`
- `hf collections delete-item COLLECTION_SLUG ITEM_OBJECT_ID` — 从集合中删除项目。`[--missing-ok --format [auto|human|agent|json|quiet]]`
- `hf collections info COLLECTION_SLUG` — 获取 Hub 上集合的信息。`[--format [auto|human|agent|json|quiet]]`
- `hf collections list` — 列出 Hub 上的集合。`[--owner TEXT --item TEXT --sort [lastModified|trending|upvotes] --limit INTEGER --format [auto|human|agent|json|quiet]]`
- `hf collections update COLLECTION_SLUG` — 更新 Hub 上集合的元数据。`[--title TEXT --description TEXT --position INTEGER --private --theme TEXT --format [auto|human|agent|json|quiet]]`
- `hf collections update-item COLLECTION_SLUG ITEM_OBJECT_ID` — 更新集合中的项目。`[--note TEXT --position INTEGER --format [auto|human|agent|json|quiet]]`

### `hf datasets` — 与 Hub 上的数据集交互。

- `hf datasets card DATASET_ID` — 获取 Hub 上数据集的数据集卡片（README）。`[--metadata --text --format [auto|human|agent|json|quiet]]`
- `hf datasets info DATASET_ID` — 获取 Hub 上数据集的信息。`[--revision TEXT --expand TEXT --format [auto|human|agent|json|quiet]]`
- `hf datasets leaderboard DATASET_ID` — 列出数据集排行榜上的模型分数。此命令帮助为某项任务找到最佳模型，或按基准分数比较模型。使用 'hf datasets ls --filter benchmark:official' 列出可用排行榜。`[--limit INTEGER --format [auto|human|agent|json|quiet]]`
- `hf datasets list` — 列出 Hub 上的数据集，或数据集仓库中的文件。`[--search TEXT --author TEXT --filter TEXT --sort [created_at|downloads|last_modified|likes|trending_score] --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format [auto|human|agent|json|quiet]]`
- `hf datasets parquet DATASET_ID` — 列出数据集可用的 parquet 文件 URL。`[--subset TEXT --split TEXT --format [auto|human|agent|json|quiet]]`
- `hf datasets sql SQL` — 使用 DuckDB 对数据集 parquet URL 执行原始 SQL 查询。`[--format [auto|human|agent|json|quiet]]`

### `hf discussions` — 管理 Hub 上的讨论和拉取请求。

- `hf discussions close REPO_ID NUM` — 关闭讨论或拉取请求。`[--comment TEXT --yes --type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf discussions comment REPO_ID NUM` — 对讨论或拉取请求发表评论。`[--body TEXT --body-file PATH --type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf discussions create REPO_ID --title TEXT` — 在仓库上创建新讨论或拉取请求。`[--body TEXT --body-file PATH --pull-request --type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf discussions diff REPO_ID NUM` — 显示拉取请求的差异。`[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf discussions edit REPO_ID NUM COMMENT_ID` — 编辑讨论或拉取请求中已有的评论。`[--body TEXT --body-file PATH --type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf discussions info REPO_ID NUM` — 获取讨论或拉取请求的信息。`[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf discussions list REPO_ID` — 列出仓库上的讨论和拉取请求。`[--status [open|closed|merged|draft|all] --kind [all|discussion|pull_request] --author TEXT --limit INTEGER --type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf discussions merge REPO_ID NUM` — 合并拉取请求。`[--comment TEXT --yes --type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf discussions rename REPO_ID NUM NEW_TITLE` — 重命名讨论或拉取请求。`[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf discussions reopen REPO_ID NUM` — 重新打开已关闭的讨论或拉取请求。`[--comment TEXT --yes --type [model|dataset|space] --format [auto|human|agent|json|quiet]]`

### `hf endpoints` — 管理 Hugging Face 推理端点。

- `hf endpoints catalog deploy --repo TEXT` — 从模型目录部署推理端点。`[--name TEXT --accelerator TEXT --namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf endpoints catalog list` — 列出可用的目录模型。`[--format [auto|human|agent|json|quiet]]`
- `hf endpoints delete NAME` — 永久删除推理端点。`[--namespace TEXT --yes --format [auto|human|agent|json|quiet]]`
- `hf endpoints deploy NAME --repo TEXT --framework TEXT --accelerator TEXT --instance-size TEXT --instance-type TEXT --region TEXT --vendor TEXT` — 从 Hub 仓库部署推理端点。`[--namespace TEXT --task TEXT --min-replica INTEGER --max-replica INTEGER --scale-to-zero-timeout INTEGER --scaling-metric [pendingRequests|hardwareUsage] --scaling-threshold FLOAT --revision TEXT --custom-image TEXT --health-route TEXT --port INTEGER --container-command TEXT --container-args TEXT --env TEXT --env-file TEXT --secrets TEXT --secrets-file TEXT --type [public|protected|authenticated|private] --format [auto|human|agent|json|quiet]]`
- `hf endpoints describe NAME` — 获取现有端点的信息。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf endpoints list` — 列出给定命名空间的所有推理端点。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf endpoints pause NAME` — 暂停推理端点。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf endpoints resume NAME` — 恢复推理端点。`[--namespace TEXT --fail-if-already-running --format [auto|human|agent|json|quiet]]`
- `hf endpoints scale-to-zero NAME` — 将推理端点缩放到零。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf endpoints update NAME` — 更新现有端点。`[--namespace TEXT --repo TEXT --accelerator TEXT --instance-size TEXT --instance-type TEXT --framework TEXT --revision TEXT --task TEXT --min-replica INTEGER --max-replica INTEGER --scale-to-zero-timeout INTEGER --scaling-metric [pendingRequests|hardwareUsage] --scaling-threshold FLOAT --format [auto|human|agent|json|quiet]]`

### `hf extensions` — 管理 hf CLI 扩展。

- `hf extensions exec NAME` — 执行已安装的扩展。
- `hf extensions install REPO_ID` — 从公共 GitHub 仓库安装扩展。`[--force --format [auto|human|agent|json|quiet]]`
- `hf extensions list` — 列出已安装的扩展命令。`[--format [auto|human|agent|json|quiet]]`
- `hf extensions remove NAME` — 移除已安装的扩展。`[--format [auto|human|agent|json|quiet]]`
- `hf extensions search` — 搜索 GitHub 上可用的扩展（标记为 'hf-extension' 主题）。`[--format [auto|human|agent|json|quiet]]`
- `hf extensions update` — 将已安装的扩展更新到最新版本。`[--format [auto|human|agent|json|quiet]]`

### `hf jobs` — 在 Hub 上运行和管理作业。

- `hf jobs cancel JOB_ID` — 取消作业 `[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs hardware` — 列出作业可用的硬件选项 `[--format [auto|human|agent|json|quiet]]`
- `hf jobs inspect JOB_IDS` — 显示一个或多个作业的详细信息 `[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs labels JOB_ID` — 更新作业的标签。替换所有现有标签。`[--label TEXT --clear --namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs list` — 列出作业。`[--all --status [COMPLETED|CANCELED|ERROR|DELETED|SCHEDULING|RUNNING] --label TEXT --limit INTEGER --namespace TEXT --filter TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs logs JOB_ID` — 获取作业的日志。`[--follow --tail INTEGER --namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs run IMAGE COMMAND` — 运行作业。`[--env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --timeout TEXT --detach --expose INTEGER --ssh --namespace TEXT]`
- `hf jobs scheduled delete SCHEDULED_JOB_ID` — 删除计划作业。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs scheduled inspect SCHEDULED_JOB_IDS` — 显示一个或多个计划作业的详细信息 `[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs scheduled labels SCHEDULED_JOB_ID` — 更新计划作业的标签。替换所有现有标签。`[--label TEXT --clear --namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs scheduled list` — 列出计划作业 `[--all --namespace TEXT --filter TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs scheduled resume SCHEDULED_JOB_ID` — 恢复（取消暂停）计划作业。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs scheduled run SCHEDULE IMAGE COMMAND` — 计划作业。`[--suspend --concurrency --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --timeout TEXT --expose INTEGER --namespace TEXT]`
- `hf jobs scheduled suspend SCHEDULED_JOB_ID` — 暂停（挂起）计划作业。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs scheduled trigger SCHEDULED_JOB_ID` — 立即触发计划作业运行一次（不改变原有计划）。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs scheduled uv run SCHEDULE SCRIPT` — 在 HF 基础设施上运行 UV 脚本（本地文件或 URL）`[--suspend --concurrency --image TEXT --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --expose INTEGER --namespace TEXT --with TEXT --python TEXT]`
- `hf jobs ssh JOB_ID` — SSH 到正在运行的作业。`[--identity-file PATH --dry-run --namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs stats` — 获取作业的资源使用统计和指标 `[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf jobs uv run SCRIPT` — 在 HF 基础设施上运行 UV 脚本（本地文件或 URL）`[--image TEXT --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --detach --expose INTEGER --ssh --namespace TEXT --with TEXT --python TEXT]`
- `hf jobs wait JOB_IDS` — 等待一个或多个作业进入终止状态。`[--timeout TEXT --namespace TEXT --format [auto|human|agent|json|quiet]]`

### `hf models` — 与 Hub 上的模型交互。

- `hf models card MODEL_ID` — 获取 Hub 上模型的模型卡片（README）。`[--metadata --text --format [auto|human|agent|json|quiet]]`
- `hf models info MODEL_ID` — 获取 Hub 上模型的信息。`[--revision TEXT --expand TEXT --format [auto|human|agent|json|quiet]]`
- `hf models list` — 列出 Hub 上的模型，或模型仓库中的文件。`[--search TEXT --author TEXT --filter TEXT --pipeline-tag TEXT --gated --apps TEXT --num-parameters TEXT --inference-provider [cerebras|cohere|deepinfra|fal-ai|featherless-ai|fireworks-ai|groq|hf-inference|novita|nscale|openai|ovhcloud|publicai|replicate|scaleway|together|wavespeed|zai-org] --warm --sort [created_at|downloads|last_modified|likes|trending_score] --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format [auto|human|agent|json|quiet]]`

### `hf papers` — 与 Hub 上的论文交互。

- `hf papers info PAPER_ID` — 获取 Hub 上论文的信息。`[--format [auto|human|agent|json|quiet]]`
- `hf papers list` — 列出 Hub 上的每日论文。`[--date TEXT --week TEXT --month TEXT --submitter TEXT --sort [publishedAt|trending] --limit INTEGER --format [auto|human|agent|json|quiet]]`
- `hf papers read PAPER_ID` — 以 markdown 格式阅读论文。`[--format [auto|human|agent|json|quiet]]`
- `hf papers search QUERY` — 在 Hub 上搜索论文。`[--limit INTEGER --format [auto|human|agent|json|quiet]]`

### `hf repos` — 管理 Hub 上的仓库。

- `hf repos branch create REPO_ID BRANCH` — 为 Hub 上的仓库创建新分支。`[--revision TEXT --type [model|dataset|space] --exist-ok --format [auto|human|agent|json|quiet]]`
- `hf repos branch delete REPO_ID BRANCH` — 从 Hub 上的仓库删除分支。`[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf repos cp SRC` — 在本地路径、仓库和存储桶之间复制文件。`[--format [auto|human|agent|json|quiet]]`
- `hf repos create REPO_ID` — 在 Hub 上创建新仓库。`[--type [model|dataset|space] --sdk TEXT --template TEXT --private --public --protected --exist-ok --resource-group-id TEXT --region [us|eu] --flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8] --storage [small|medium|large] --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT --volume TEXT --format [auto|human|agent|json|quiet]]`
- `hf repos delete REPO_ID` — 从 Hub 中删除仓库。这是不可逆操作。`[--type [model|dataset|space] --missing-ok --yes --format [auto|human|agent|json|quiet]]`
- `hf repos delete-files REPO_ID PATTERNS` — 从 Hub 上的仓库删除文件。`[--type [model|dataset|space] --revision TEXT --commit-message TEXT --commit-description TEXT --create-pr --format [auto|human|agent|json|quiet]]`
- `hf repos duplicate FROM_ID` — 在 Hub 上复制仓库（模型、数据集或 Space）。`[--type [model|dataset|space] --private --public --protected --exist-ok --flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8] --storage [small|medium|large] --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT --volume TEXT --format [auto|human|agent|json|quiet]]`
- `hf repos list` — 列出所有仓库（模型、数据集、spaces、存储桶）及存储信息。`[--namespace TEXT --type [model|dataset|space|bucket] --search TEXT --limit INTEGER --explore --format [auto|human|agent|json|quiet]]`
- `hf repos move FROM_ID TO_ID` — 将仓库从一个命名空间移动到另一个命名空间。`[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf repos settings REPO_ID` — 更新仓库的设置。`[--gated [auto|manual|false] --private --public --protected --type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf repos tag create REPO_ID TAG` — 为仓库创建标签。`[--message TEXT --revision TEXT --type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf repos tag delete REPO_ID TAG` — 删除仓库的标签。`[--yes --type [model|dataset|space] --format [auto|human|agent|json|quiet]]`
- `hf repos tag list REPO_ID` — 列出仓库的标签。`[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]`

### `hf sandbox` — 在 Hugging Face Jobs 上运行和管理沙盒。

- `hf sandbox cp SRC DST` — 在本地机器和沙盒之间复制文件（Docker 风格）。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf sandbox create` — 创建沙盒：默认是独占的虚拟机，使用 `--pool` 则是低成本的共享沙盒。`[--pool TEXT --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --idle-timeout TEXT --env TEXT --secrets TEXT --env-file TEXT --secrets-file TEXT --volume TEXT --namespace TEXT --forward-hf-token --format [auto|human|agent|json|quiet]]`
- `hf sandbox exec SANDBOX_ID COMMAND` — 在沙盒中运行命令，流式输出结果。以该命令的退出码退出。`[--workdir TEXT --env TEXT --env-file TEXT --timeout FLOAT --namespace TEXT]`
- `hf sandbox kill` — 终止一个沙盒、一整个共享宿主，或所有沙盒（--all）。`[--all --yes --namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf sandbox pool create` — 预热一个池：立即启动一台宿主虚拟机，并打上标记以便之后通过池 ID 找到它。`[--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --per-host INTEGER RANGE --max-hosts INTEGER RANGE --idle-timeout TEXT --namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf sandbox pool delete POOL_ID` — 终止某个池的所有宿主虚拟机（也就终止了其所有沙盒）。`[--yes --namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf sandbox pool ls` — 列出正在运行的沙盒池（按其宿主虚拟机分组）。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf sandbox process kill SANDBOX_ID PID` — 停止沙盒中正在运行的后台进程。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf sandbox process ls SANDBOX_ID` — 列出沙盒中正在运行的后台进程（由 `hf sandbox spawn` 启动）。`[--namespace TEXT --format [auto|human|agent|json|quiet]]`
- `hf sandbox spawn SANDBOX_ID COMMAND` — 在后台启动一个长时间运行的命令并返回其 pid（不等待其完成）。`[--workdir TEXT --env TEXT --env-file TEXT --namespace TEXT]`

### `hf skills` — 管理 AI 助手的技能。

- `hf skills add` — 为 AI 助手安装 Hugging Face 技能。`[--claude --global --dest PATH --force --format [auto|human|agent|json|quiet]]`
- `hf skills list` — 列出 Hugging Face 市场上的可用技能。`[--format [auto|human|agent|json|quiet]]`
- `hf skills preview` — 将生成的 `hf-cli` SKILL.md 打印到 stdout。`[--format [auto|human|agent|json|quiet]]`
- `hf skills update` — 更新已安装的 Hugging Face 市场技能。`[--claude --global --dest PATH --format [auto|human|agent|json|quiet]]`

### `hf spaces` — 与 Hub 上的 spaces 交互。

- `hf spaces card SPACE_ID` — 获取 Hub 上 Space 的 Space 卡片（README）。`[--metadata --text --format [auto|human|agent|json|quiet]]`
- `hf spaces dev-mode SPACE_ID` — 在 Space 上启用或禁用开发模式。`[--stop --format [auto|human|agent|json|quiet]]`
- `hf spaces hardware` — 列出 Spaces 可用的硬件选项。`[--format [auto|human|agent|json|quiet]]`
- `hf spaces hot-reload SPACE_ID` — 热重载 Space 的任何 Python 文件，无需完全重建 + 重启。`[--local-file PATH --skip-checks --skip-summary --format [auto|human|agent|json|quiet]]`
- `hf spaces info SPACE_ID` — 获取 Hub 上 space 的信息。`[--revision TEXT --expand TEXT --format [auto|human|agent|json|quiet]]`
- `hf spaces list` — 列出 Hub 上的 spaces，或 space 仓库中的文件。`[--search TEXT --author TEXT --filter TEXT --sort [created_at|last_modified|likes|trending_score] --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format [auto|human|agent|json|quiet]]`
- `hf spaces logs SPACE_ID` — 获取 Space 的运行或构建日志。`[--build --follow --tail INTEGER --format [auto|human|agent|json|quiet]]`
- `hf spaces pause SPACE_ID` — 暂停 Space。`[--format [auto|human|agent|json|quiet]]`
- `hf spaces restart SPACE_ID` — 重启 Space。`[--factory-reboot --format [auto|human|agent|json|quiet]]`
- `hf spaces search QUERY` — 使用语义搜索在 Hub 上搜索 spaces。`[--filter TEXT --sdk TEXT --include-non-running --description --limit INTEGER --format [auto|human|agent|json|quiet]]`
- `hf spaces secrets add SPACE_ID` — 为 Space 添加或更新 secrets。`[--secrets TEXT --secrets-file TEXT --format [auto|human|agent|json|quiet]]`
- `hf spaces secrets delete SPACE_ID KEY` — 从 Space 中移除 secret。`[--yes --format [auto|human|agent|json|quiet]]`
- `hf spaces secrets list SPACE_ID` — 列出 Space 的 secrets。Secret 值是只写的，不会返回。`[--format [auto|human|agent|json|quiet]]`
- `hf spaces settings SPACE_ID` — 更新 Space 的设置。`[--sleep-time INTEGER --hardware [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8] --format [auto|human|agent|json|quiet]]`
- `hf spaces ssh SPACE_ID` — SSH 到 Space 的 Dev Mode 容器。`[--identity-file PATH --dry-run --auto --format [auto|human|agent|json|quiet]]`
- `hf spaces templates` — 列出可用的 Space 模板。`[--format [auto|human|agent|json|quiet]]`
- `hf spaces variables add SPACE_ID` — 为 Space 添加或更新环境变量。`[--env TEXT --env-file TEXT --format [auto|human|agent|json|quiet]]`
- `hf spaces variables delete SPACE_ID KEY` — 从 Space 中移除环境变量。`[--yes --format [auto|human|agent|json|quiet]]`
- `hf spaces variables list SPACE_ID` — 列出 Space 的环境变量。`[--format [auto|human|agent|json|quiet]]`
- `hf spaces volumes delete SPACE_ID` — 从 Space 中删除所有卷。`[--yes --format [auto|human|agent|json|quiet]]`
- `hf spaces volumes list SPACE_ID` — 列出 Space 中挂载的卷。`[--format [auto|human|agent|json|quiet]]`
- `hf spaces volumes set SPACE_ID` — 为 Space 设置（替换）卷。`[--volume TEXT --format [auto|human|agent|json|quiet]]`
- `hf spaces wait SPACE_ID` — 等待 Space 完成构建/启动。`[--timeout TEXT --format [auto|human|agent|json|quiet]]`

### `hf webhooks` — 管理 Hub 上的 webhook。

- `hf webhooks create --watch TEXT` — 创建新 webhook。`[--url TEXT --job-id TEXT --domain [repo|discussions] --secret TEXT --format [auto|human|agent|json|quiet]]`
- `hf webhooks delete WEBHOOK_ID` — 永久删除 webhook。`[--yes --format [auto|human|agent|json|quiet]]`
- `hf webhooks disable WEBHOOK_ID` — 禁用活动 webhook。`[--format [auto|human|agent|json|quiet]]`
- `hf webhooks enable WEBHOOK_ID` — 启用已禁用的 webhook。`[--format [auto|human|agent|json|quiet]]`
- `hf webhooks info WEBHOOK_ID` — 显示单个 webhook 的完整详细信息。`[--format [auto|human|agent|json|quiet]]`
- `hf webhooks list` — 列出当前用户的所有 webhook。`[--format [auto|human|agent|json|quiet]]`
- `hf webhooks update WEBHOOK_ID` — 更新现有 webhook。仅更改提供的选项。`[--url TEXT --watch TEXT --domain [repo|discussions] --secret TEXT --format [auto|human|agent|json|quiet]]`

## 通用选项

- `--format` — 输出格式：`--format json`（或 `--json`）或 `--format table`（默认）。
- `-q / --quiet` — 仅打印 ID（每行一个）。
- `--revision` — Git 修订 ID，可以是分支名称、标签或提交哈希。
- `--token` — 使用用户访问令牌。优先设置 `HF_TOKEN` 环境变量，而不是传递 `--token`。
- `--type` — 仓库类型（model、dataset 或 space）。

## 将仓库挂载为本地文件系统

要将 Hub 仓库或存储桶挂载为本地文件系统 — 无需下载、复制、等待 — 使用 `hf-mount`。文件按需获取。GitHub：https://github.com/huggingface/hf-mount

安装：`curl -fsSL https://raw.githubusercontent.com/huggingface/hf-mount/main/install.sh | sh`

一些命令示例：
- `hf-mount start repo openai-community/gpt2 /tmp/gpt2` — 挂载仓库（只读）
- `hf-mount start --hf-token $HF_TOKEN bucket myuser/my-bucket /tmp/data` — 挂载存储桶（读写）
- `hf-mount status` / `hf-mount stop /tmp/data` — 列出或卸载

## 提示

- 使用 `hf <command> --help` 获取完整选项、描述、用法和实际示例
- 使用 `HF_TOKEN` 环境变量（推荐）或 `--token` 进行认证
- 使用 `hf update` 更新 CLI（使用检测到的安装方法的正确命令）