用途:hf 是 Hugging Face Hub 的命令行工具,用于在终端中完成 Hub 上的认证、下载、上传、仓库、缓存、Jobs、Buckets、Webhook 与端点管理等操作。资料说明 hf 命令已取代弃用的 huggingface-cli,认证相关命令统一归入 hf auth(例如 hf auth whoami)。
安装:curl -LsSf https://hf.co/cli/install.sh | bash -s。可用 hf --help 查看可用功能;资料标注由 huggingface_hub v1.23.0 生成。
主要能力:认证管理(login、logout、switch、token、whoami、list);文件传输含 hf cp、hf download、hf upload(单次提交推荐)、hf upload-large-folder(已弃用,建议改用 hf upload);缓存管理 hf cache list/prune/rm/verify;仓库与数据集、集合、讨论与 PR、模型卡片等操作;hf jobs 运行与调度任务(含硬件选项、日志、SSH、UV 脚本);hf buckets 对象存储操作;hf endpoints 管理 Inference Endpoints(部署、更新、暂停、恢复、缩容至零等);hf extensions 管理扩展。多数命令支持 --format 输出格式选项。
使用方式:按命令语法执行,如 hf download REPO_ID、hf upload REPO_ID、hf auth login 等;可参考官方命令帮助确认参数。
限制:资料仅列出命令与参数,未提供收费、价格、平台限制、效果或排名等细节;部分命令标记为已弃用(如 upload-large-folder)。