kscz0000 先下载安装脚本，检查后再本地运行。示例：
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— 同步本地目录与存储桶之间的文件。[--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— 使用 nuggingface.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 — 与存储桶交互的命令。
hf buckets cp SRC— 复制单个文件到或从存储桶。[--quiet]hf buckets create BUCKET_ID— 创建新存储桶。[--private --exist-ok --quiet]hf buckets delete BUCKET_ID— 删除存储桶。[--yes --missing-ok --quiet]hf buckets info BUCKET_ID— 获取存储桶信息。[--quiet]hf buckets list— 列出存储桶或桶内文件。[--human-readable --tree --recursive --format CHOICE --quiet]hf buckets move FROM_ID TO_ID— 移动（重命名）存储桶到新名称或命名空间。hf buckets remove ARGUMENT— 从存储桶中删除文件。[--recursive --yes --dry-run --include TEXT --exclude TEXT --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 --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 delete-item COLLECTION_SLUG ITEM_OBJECT_ID— 从集合中删除项目。[--missing-ok]hf collections info COLLECTION_SLUG— 获取 Hub 上集合的信息。输出为 JSON 格式。hf collections list— 列出 Hub 上的集合。[--owner TEXT --item TEXT --sort CHOICE --limit INTEGER --format CHOICE --quiet]hf collections update COLLECTION_SLUG— 更新 Hub 上集合的元数据。[--title TEXT --description TEXT --position INTEGER --private --theme TEXT]hf collections update-item COLLECTION_SLUG ITEM_OBJECT_ID— 更新集合中的项目。[--note TEXT --position INTEGER]
hf datasets — 与 Hub 上的数据集交互。
hf datasets info DATASET_ID— 获取 Hub 上数据集的信息。输出为 JSON 格式。[--revision TEXT --expand TEXT]hf datasets list— 列出 Hub 上的数据集。[--search TEXT --author TEXT --filter TEXT --sort CHOICE --limit INTEGER --expand TEXT --format CHOICE --quiet]hf datasets parquet DATASET_ID— 列出数据集可用的 parquet 文件 URL。[--subset TEXT --split TEXT --format CHOICE --quiet]hf datasets sql SQL— 使用 DuckDB 对数据集 parquet URL 执行原始 SQL 查询。[--format CHOICE]
hf discussions — 管理 Hub 上的讨论和拉取请求。
hf discussions close REPO_ID NUM— 关闭讨论或拉取请求。[--comment TEXT --yes --type CHOICE]hf discussions comment REPO_ID NUM— 在讨论或拉取请求中评论。[--body TEXT --body-file PATH --type CHOICE]hf discussions create REPO_ID --title TEXT— 在仓库中创建新讨论或拉取请求。[--body TEXT --body-file PATH --pull-request --type CHOICE]hf discussions diff REPO_ID NUM— 显示拉取请求的差异。[--type CHOICE]hf discussions info REPO_ID NUM— 获取讨论或拉取请求的信息。[--comments --diff --no-color --type CHOICE --format CHOICE]hf discussions list REPO_ID— 列出仓库中的讨论和拉取请求。[--status CHOICE --kind CHOICE --author TEXT --limit INTEGER --type CHOICE --format CHOICE --quiet]hf discussions merge REPO_ID NUM— 合并拉取请求。[--comment TEXT --yes --type CHOICE]hf discussions rename REPO_ID NUM NEW_TITLE— 重命名讨论或拉取请求。[--type CHOICE]hf discussions reopen REPO_ID NUM— 重新打开已关闭的讨论或拉取请求。[--comment TEXT --yes --type CHOICE]
hf endpoints — 管理 Hugging Face 推理端点。
hf endpoints catalog deploy --repo TEXT— 从模型目录部署推理端点。[--name TEXT --accelerator TEXT --namespace TEXT]hf endpoints catalog list— 列出可用的目录模型。hf endpoints delete NAME— 永久删除推理端点。[--namespace TEXT --yes]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 CHOICE --scaling-threshold FLOAT]hf endpoints describe NAME— 获取现有端点的信息。[--namespace TEXT]hf endpoints list— 列出指定命名空间的所有推理端点。[--namespace TEXT --format CHOICE --quiet]hf endpoints pause NAME— 暂停推理端点。[--namespace TEXT]hf endpoints resume NAME— 恢复推理端点。[--namespace TEXT --fail-if-already-running]hf endpoints scale-to-zero NAME— 将推理端点缩容至零。[--namespace TEXT]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 CHOICE --scaling-threshold FLOAT]
hf extensions — 管理 hf CLI 扩展。
hf extensions exec NAME— 执行已安装的扩展。hf extensions install REPO_ID— 从公开 GitHub 仓库安装扩展。[--force]hf extensions list— 列出已安装的扩展命令。[--format CHOICE --quiet]hf extensions remove NAME— 移除已安装的扩展。hf extensions search— 搜索 GitHub 上可用的扩展（标记为 'hf-extension' 主题）。[--format CHOICE --quiet]
hf jobs — 在 Hub 上运行和管理作业。
hf jobs cancel JOB_ID— 取消作业[--namespace TEXT]hf jobs hardware— 列出作业可用的硬件选项hf jobs inspect JOB_IDS— 显示一个或多个作业的详细信息[--namespace TEXT]hf jobs logs JOB_ID— 获取作业日志。[--follow --tail INTEGER --namespace TEXT]hf jobs ps— 列出作业。[--all --namespace TEXT --filter TEXT --format TEXT --quiet]hf jobs run IMAGE COMMAND— 运行作业。[--env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor CHOICE --timeout TEXT --detach --namespace TEXT]hf jobs scheduled delete SCHEDULED_JOB_ID— 删除计划作业。[--namespace TEXT]hf jobs scheduled inspect SCHEDULED_JOB_IDS— 显示一个或多个计划作业的详细信息[--namespace TEXT]hf jobs scheduled ps— 列出计划作业[--all --namespace TEXT --filter TEXT --format TEXT --quiet]hf jobs scheduled resume SCHEDULED_JOB_ID— 恢复（取消暂停）计划作业。[--namespace TEXT]hf jobs scheduled run SCHEDULE IMAGE COMMAND— 计划作业。[--suspend --concurrency --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor CHOICE --timeout TEXT --namespace TEXT]hf jobs scheduled suspend SCHEDULED_JOB_ID— 暂停计划作业。[--namespace TEXT]hf jobs scheduled uv run SCHEDULE SCRIPT— 在 HF 基础设施上运行 UV 脚本（本地文件或 URL）[--suspend --concurrency --image TEXT --flavor CHOICE --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --namespace TEXT --with TEXT --python TEXT]hf jobs stats— 获取作业的资源使用统计和指标[--namespace TEXT]hf jobs uv run SCRIPT— 在 HF 基础设施上运行 UV 脚本（本地文件或 URL）[--image TEXT --flavor CHOICE --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --detach --namespace TEXT --with TEXT --python TEXT]
hf models — 与 Hub 上的模型交互。
hf models info MODEL_ID— 获取 Hub 上模型的信息。输出为 JSON 格式。[--revision TEXT --expand TEXT]hf models list— 列出 Hub 上的模型。[--search TEXT --author TEXT --filter TEXT --num-parameters TEXT --sort CHOICE --limit INTEGER --expand TEXT --format CHOICE --quiet]
hf papers — 与 Hub 上的论文交互。
hf papers info PAPER_ID— 获取 Hub 上论文的信息。输出为 JSON 格式。hf papers list— 列出 Hub 上的每日论文。[--date TEXT --week TEXT --month TEXT --submitter TEXT --sort CHOICE --limit INTEGER --format CHOICE --quiet]hf papers read PAPER_ID— 以 markdown 格式阅读论文。hf papers search QUERY— 在 Hub 上搜索论文。[--limit INTEGER --format CHOICE --quiet]
hf repos — 管理 Hub 上的仓库。
hf repos branch create REPO_ID BRANCH— 为 Hub 上的仓库创建新分支。[--revision TEXT --type CHOICE --exist-ok]hf repos branch delete REPO_ID BRANCH— 从 Hub 上的仓库删除分支。[--type CHOICE]hf repos create REPO_ID— 在 Hub 上创建新仓库。[--type CHOICE --space-sdk TEXT --private --public --protected --exist-ok --resource-group-id TEXT --flavor TEXT --storage TEXT --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT]hf repos delete REPO_ID— 从 Hub 删除仓库。此操作不可逆。[--type CHOICE --missing-ok]hf repos delete-files REPO_ID PATTERNS— 从 Hub 上的仓库删除文件。[--type CHOICE --revision TEXT --commit-message TEXT --commit-description TEXT --create-pr]hf repos duplicate FROM_ID— 复制 Hub 上的仓库（模型、数据集或 Space）。[--type CHOICE --private --public --protected --exist-ok --flavor TEXT --storage TEXT --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT]hf repos move FROM_ID TO_ID— 将仓库从一个命名空间移动到另一个命名空间。[--type CHOICE]hf repos settings REPO_ID— 更新仓库设置。[--gated CHOICE --private --public --protected --type CHOICE]hf repos tag create REPO_ID TAG— 为仓库创建标签。[--message TEXT --revision TEXT --type CHOICE]hf repos tag delete REPO_ID TAG— 删除仓库标签。[--yes --type CHOICE]hf repos tag list REPO_ID— 列出仓库标签。[--type CHOICE]
hf skills — 管理 AI 助手的技能。
hf skills add— 下载技能并为 AI 助手安装。[--claude --codex --cursor --opencode --global --dest PATH --force]hf skills preview— 将生成的 SKILL.md 打印到标准输出。
hf spaces — 与 Hub 上的 Spaces 交互。
hf spaces dev-mode SPACE_ID— 启用或禁用 Space 的开发模式。[--stop]hf spaces hot-reload SPACE_ID— 无需完整重建和重启即可热重载 Space 的任意 Python 文件。[--local-file TEXT --skip-checks --skip-summary]hf spaces info SPACE_ID— 获取 Hub 上 Space 的信息。输出为 JSON 格式。[--revision TEXT --expand TEXT]hf spaces list— 列出 Hub 上的 Spaces。[--search TEXT --author TEXT --filter TEXT --sort CHOICE --limit INTEGER --expand TEXT --format CHOICE --quiet]
hf webhooks — 管理 Hub 上的 Webhook。
hf webhooks create --watch TEXT— 创建新 webhook。[--url TEXT --job-id TEXT --domain CHOICE --secret TEXT]hf webhooks delete WEBHOOK_ID— 永久删除 webhook。[--yes]hf webhooks disable WEBHOOK_ID— 禁用活跃的 webhook。hf webhooks enable WEBHOOK_ID— 启用已禁用的 webhook。hf webhooks info WEBHOOK_ID— 以 JSON 格式显示单个 webhook 的完整详情。hf webhooks list— 列出当前用户的所有 webhook。[--format CHOICE --quiet]hf webhooks update WEBHOOK_ID— 更新现有 webhook。仅更改提供的选项。[--url TEXT --watch TEXT --domain CHOICE --secret TEXT]
常用选项
--format— 输出格式：--format json（或--json）或--format table（默认）。-q / --quiet— 最小化输出。--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 -o /tmp/hf-mount-install.sh && less /tmp/hf-mount-install.sh && sh /tmp/hf-mount-install.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
限制
- 仅在任务明确符合上述描述范围时使用此技能。
- 输出不能替代环境特定的验证、测试或专家审查。
- 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。