Hugging Face CLI

Hugging Face Hub 命令行工具,管理模型、数据集等资源。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Hugging Face CLI。
它的用途是:Hugging Face Hub 命令行工具,管理模型、数据集等资源。
完整的 Skill 内容见:https://321skill.com/skills/hugging-face-cli-x-3/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'用hf CLI从Hugging Face下载微调过的Llama-3-8B模型到当前目录',它会执行 `hf download meta-llama/Llama-3-8B --local-dir ./llama3`,自动处理认证(若未登录则提示登录),并显示下载进度条,完成后将模型文件保存到指定目录。

介绍

Hugging Face CLI(hf)让你通过命令行直接与 Hugging Face Hub 交互,无需浏览器即可完成模型、数据集、Spaces、仓库、论文、作业等多种资源的下载、上传和管理操作。它解决了频繁切换网页、手动处理认证和文件路径的痛点,将 Hub 的核心功能统一在终端中,特别适合需要进行批量操作、自动化脚本集成或远程服务器管理的场景。

使用方式非常简单:安装后,通过 hf login 登录账号,然后用 hf downloadhf uploadhf list 等子命令即可执行对应操作。所有命令都支持参数化配置,如指定模型版本、缓存目录、并发数等,方便集成到 CI/CD 流水线或自动化工作流中。

适合用户包括:AI 开发者(需要频繁下载/上传模型和数据集)、机器学习工程师(管理训练实验中的资源版本)、运维工程师(在服务器上部署模型服务)、学术研究者(快速获取公开数据集和预训练模型)以及量化交易员(使用 Hugging Face 上的金融模型)。

使用建议:注意网络稳定性,大型模型下载建议使用代理或断点续传;妥善管理 API 密钥(设置环境变量 HF_TOKEN),避免在命令行明文输入;对于以数据集为主的用户,可配合 hf datasets 子命令提高效率。

核心特点

与直接使用 Hugging Face 的 HTTP API 或 git lfs 相比,hf CLI 提供了统一、简洁的命令行接口,天然支持认证令牌管理,并内置了文件校验、断点续传、并发下载等优化,无需额外编写脚本。

注意事项

依赖 Hugging Face Hub 在线服务,无法离线使用;部分高级功能(如组织管理、Spaces 日志实时查看)仍需通过 Web 界面完成。

常见问题

如何安装 hf CLI?

执行 `pip install huggingface-hub`,安装后命令行输入 `hf` 即可使用。

如何下载一个模型到本地?

使用 `hf download <模型ID>`,例如 `hf download bert-base-uncased`,会自动下载到缓存目录。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/hugging-face-cli-x-3/raw/index.md 读取 Hugging Face CLI 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。