用途:hf 是与 Hugging Face Hub 交互的现代命令行工具,取代已弃用的 huggingface-cli,用于管理仓库、模型、数据集和 Spaces。
安装与帮助:安装命令 curl -LsSf https://hf.co/cli/install.sh | bash -s ;使用 hf --help 查看全部功能与示例。认证推荐使用 HF_TOKEN 环境变量或 --token 参数,令牌来自 huggingface.co/settings/tokens。
核心命令:hf download REPO_ID 下载;hf upload REPO_ID 上传文件或文件夹(适合单次提交);hf upload-large-folder REPO_ID LOCAL_PATH 适合大目录的断点续传;hf sync 在本地目录与 bucket 间同步;hf env、hf version 查看环境与版本。
认证(hf auth):login/logout 管理会话,list/switch 管理多个令牌,whoami 查看当前账户。
仓库管理(hf repos):create/delete 创建或删除仓库,duplicate 复制模型、数据集或 Space,move 在命名空间间转移,branch/tag 管理类 Git 引用,delete-files 按模式删除文件。
数据与模型:数据集可用 hf datasets list、info、parquet(列出 parquet URL),并支持 hf datasets sql 通过 DuckDB 对数据集 parquet URL 执行 SQL;模型用 hf models list 和 info;论文用 hf papers list 查看每日论文。
讨论与 PR(hf discussions):支持 list、create、info、comment、close、reopen、rename,diff 查看变更,merge 合并 PR。
基础设施:Endpoints 支持 deploy、pause、resume、scale-to-zero、catalog;Jobs 可在 HF 基础设施运行计算任务,含 hf jobs uv 运行带内联依赖的 Python 脚本,stats 监控资源;Spaces 支持 dev-mode 与热重载。
存储与自动化:Buckets 提供类 S3 管理(create、cp、mv、rm、sync);Cache 提供 list、prune、verify;Webhooks 可创建、监听、启停;Collections 可组织条目(add-item、update、list)。
全局参数:--format json 输出机器可读结果,-q/--quiet 仅输出 ID。扩展可用 hf extensions install REPO_ID,技能可用 hf skills add 管理。
限制:资料未提供具体版本、权限范围、配额、费用及各命令的详细参数说明,建议以 hf --help 与官方文档为准。