一本从基础到应用算法的强化学习入门小书,仓库附带 PyTorch 算法实现。
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
安装 hf 命令行工具(macOS 和 Linux)
按 README 中的官方说明安装 - 2
登录 Hugging Face Hub
hf auth login - 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 数据每日更新。
相关项目
通过动手实现来学习机器学习:基于 NumPy 从零构建的深度学习框架课程,加上 350 多道可在浏览器中运行并自动评测的编程题。
让 Unity 游戏和仿真环境成为训练智能体的平台,支持强化学习与模仿学习。
基于码本查找 Transformer 的盲人脸修复工具,可增强模糊、低质量或受损的人脸图像与视频。
收录 419 个预训练 AI 模型,覆盖视觉、语音、NLP 与大模型,可通过统一的 Python 命令行运行。
WorldGrow 是一个基于分块合成的研究代码,可从一个种子块逐步生成可行走的无限 3D 场景。