Hugging Face Hub 命令行工具：下载、上传与管理模型、数据集、Spaces 与仓库，处理认证与缓存、浏览论文、配置 Webhook 与部署推理端点，是已弃用的 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（使用检测到的安装方法的正确命令）

hf-cli

命令

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

通用选项

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

提示

兼容工具

站内相关工具

hf-cli

命令

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

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

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

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

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

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

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

hf extensions — 管理 hf CLI 扩展。

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

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

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

hf repos — 管理 Hub 上的仓库。

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

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

hf spaces — 与 Hub 上的 spaces 交互。

hf webhooks — 管理 Hub 上的 webhook。

通用选项

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

提示

兼容工具

站内相关工具

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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