Repolode
huggingface

huggingface/huggingface_hub

Hugging Face Hub 的官方命令行工具(hf)与 Python 客户端,用于下载、上传和管理仓库。

Star
3,990
Fork
1,285
未关闭 Issue
185
最近提交
19小时前

这是什么?

huggingface_hub 是 Hugging Face Hub 的官方 Python 库和命令行工具。Hub 是托管机器学习模型、数据集和 Space 应用的平台。通过它可以下载和上传文件、创建与管理仓库、搜索 Hub 内容、调用已部署模型进行推理,以及在 Hugging Face 基础设施上运行任务。

该包提供两种接口:可通过独立脚本或 pip 安装的 hf 命令行工具,以及 Python API,其中包括 hf_hub_download、snapshot_download、upload_file、upload_folder 等函数。下载的文件会保存在本地缓存目录中,重复加载时无需再次下载。

命令行工具同时面向 Claude Code、Codex、Cursor 等编程智能体设计,并可安装由 CLI 生成的命令参考技能文件。

核心功能

  • 01将单个文件或整个仓库下载到本地缓存。
  • 02向模型、数据集和 Space 上传文件或文件夹。
  • 03通过 Python 或终端创建和管理 Hub 仓库。
  • 04搜索 Hub 上的模型、数据集和 Space。
  • 05调用已部署模型进行推理,并在 Hugging Face 基础设施上运行任务。
  • 06支持使用访问令牌认证,也可用于非交互式环境。

适用场景

  • 在训练或推理流程中下载预训练模型权重。
  • 在训练脚本中将模型检查点或数据集发布到 Hub。
  • 在终端或 CI 任务中将本地文件夹同步到 Hub 存储桶。
  • 让编程智能体通过 hf 命令行工具操作 Hub 仓库。

快速上手

  1. 1

    安装 hf 命令行工具(macOS 和 Linux)

    按 README 中的官方说明安装
  2. 2

    登录 Hugging Face Hub

    hf auth login
  3. 3

    下载一个模型

    hf download Qwen/Qwen3-0.6B

使用前须知

  • 上传或管理私有仓库需要 Hugging Face 账号和令牌。

标签

常见问题

huggingface_hub 是什么?
Hugging Face Hub 的官方命令行工具(hf)与 Python 客户端,用于下载、上传和管理仓库。 huggingface_hub 是 Hugging Face Hub 的官方 Python 库和命令行工具。Hub 是托管机器学习模型、数据集和 Space 应用的平台。通过它可以下载和上传文件、创建与管理仓库、搜索 Hub 内容、调用已部署模型进行推理,以及在 Hugging Face 基础设施上运行任务。
huggingface_hub 可以免费使用吗?用的什么许可证?
huggingface_hub 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
huggingface_hub 还在维护吗?
活跃维护中。huggingface_hub 最近一次提交是在 2026年10月19日。
huggingface_hub 适合用来做什么?
在训练或推理流程中下载预训练模型权重。 在训练脚本中将模型检查点或数据集发布到 Hub。 在终端或 CI 任务中将本地文件夹同步到 Hub 存储桶。 让编程智能体通过 hf 命令行工具操作 Hub 仓库。
huggingface_hub 怎么安装和运行?
安装 hf 命令行工具(macOS 和 Linux) 登录 Hugging Face Hub: hf auth login 下载一个模型: hf download Qwen/Qwen3-0.6B
在哪里获取 huggingface_hub?
源代码和安装说明在 GitHub 上:https://github.com/huggingface/huggingface_hub

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目