把模型上传到 Hugging Face Hub
按 Hub 上传指南登录、创建仓库并推送模型文件。
基于 Hugging Face Hub 整理 · Hub · 官方资料
本地训好或导出的权重需要可分享的地址。Hugging Face Hub 是常用托管点。
这篇按官方上传流程：登录、创建模型 repo、上传文件并验证页面可见。
登录并上传
- huggingface-cli login 或设置 HF_TOKEN
- 创建 model repository
- 用 huggingface_hub 的 upload_file / upload_folder 推送
- 在模型页确认 README 与文件列表
upload_file 示意
python
from huggingface_hub import HfApi
api = HfApi()
api.upload_file(
path_or_fileobj="README.md",
path_in_repo="README.md",
repo_id="your-username/your-model",
repo_type="model",
)最容易踩的坑
权限不足
确认 token 具备 write，且 repo_id 属于你的命名空间或组织授权。