Huggingface Hub
一、项目简介
Hugging Face Hub 客户端库,用于下载、上传与管理模型、数据集与 Space。它是连接本地代码与 Hugging Face 模型生态的基础工具,几乎所有 HF 相关项目(transformers、datasets 等)都依赖它。
二、核心特性
- 模型 / 数据集下载:一行代码获取;
- 缓存与断点续传:避免重复下载;
- 上传与版本管理:可发布自有模型;
- 推理端点:支持调用云端推理;
- 与 transformers / datasets 深度集成;
- CLI 工具:命令行直接操作。
三、适用场景
- 获取开源模型与数据集;
- 发布与共享自有模型;
- CI/CD 中自动拉取模型。
四、快速上手
pip install huggingface_hub
python -c "from huggingface_hub import hf_hub_download; hf_hub_download(repo_id='google-bert/bert-base-uncased', filename='config.json')"
# 或:huggingface-cli download google-bert/bert-base-uncased
五、注意事项
- 上传/私有仓库需登录 token;
- 缓存会占用较多磁盘,注意清理;
- 注意模型许可与使用条款。