Hugging Face Hub 创建模型仓库教程

Hugging Face Hub 上的模型仓库，说起来其实不只是一个下载文件夹那么简单——它同时保存了模型卡、配置参数、权重文件，以及每次修改的历史记录。第一次动手创建的时候，最容易栽跟头的地方往往不是按钮在哪，而是 Owner 选错了、仓库名字不合适，或者没分清 Public 和 Private 的区别。

开始操作之前，账号得是能正常登录的，并且确认在目标个人空间或组织里有创建仓库的权限。公开的帮助页面虽然能展示完整界面，但真正点击 Create model 那一下，写入的是你的账号数据；如果页面把你拽回了登录页，先老老实实登录完再继续，别跳步骤。

在创建页确定仓库归属和名称

先从账号菜单找到创建入口。

登录 Hugging Face Hub 后进入 New model，页面标题会显示 Create a new model repository。如果打开后依然是登录页，说明当前会话其实没登录成功——不要在未登录状态反复提交表单，这没意义。

创建页上，第一步是确定内容归谁管。

个人项目把 Owner 设为自己的账号，团队项目则选择有创建权限的组织。然后在 Model name 里输入仓库名。页面会自动把这两项组合成完整的仓库路径。名字要简短、可识别，别夹带临时密码、客户名称或者内部编号，不然以后自己都搞不清。

图中需要重点看四处：Owner 下拉框、Model name 输入框、License 选择框，以及 Public 和 Private。它们共同决定了仓库地址、内容归属和可见范围，一个都不能马虎。

检查路径再往下走。

Owner 显示预期账号或组织，Model name 已经形成清楚的仓库路径，Create model 按钮可以正常提交。如果目标组织不在 Owner 列表里，先核对组织成员身份和当前账号是否有权限，别退回个人空间后继续创建同名仓库——那只会让事情更乱。

选好许可证和可见范围再创建

可见范围就在同一张表单里。

Create a new model repository 的下半部分包含 License、Public 和 Private。

这里要先判断内容能不能公开。

确认模型、代码和数据的授权条件之后，再选择合适的 License。如果选 Public，互联网上的访问者都能看到模型，但提交权限仍然只属于仓库所有者或组织成员。Private 则只允许仓库所有者或组织成员查看和提交。未公开的权重、内部数据，或者授权不清楚的文件，绝对不要放进 Public 仓库——这是底线。

选项确认后再点击 Create model。

可见范围与实际用途一致，许可证不是随手填的占位项。按钮无法提交时，检查模型名、Owner、重名提示和权限提示。不要连续点击按钮，免得把网络延迟误判成失败——稍微等一等，往往就解决了。

用空仓库页面确认创建结果

创建成功之后，页面会进入以 Owner 和仓库名组成的模型仓库。新仓库暂时没有模型卡和模型文件，这是正常状态，不代表创建失败。

新页面顶部是仓库功能区。

这里会出现 Model card、Files and versions、Community、Settings。先核对左上角的 Owner 和仓库名，确认页面没有停留在创建表单。如果需要补充说明，从 Model card 创建模型卡；要上传文件，转到 Files 或 Files and versions。

空白内容区不代表失败。

地址对应刚才填写的 Owner 和仓库名，仓库页可以正常打开。找不到仓库时先刷新并核对账号。如果能看到仓库但没有 Settings，说明当前账号可能只有查看权限，需要切换到仓库所有者或有维护权限的组织账号。

给新仓库加入第一个文件

文件入口位于仓库的文件页。

打开 Files 或 Files and versions，在列表右侧找到 Add file。菜单通常提供 Create a new file 和 Upload file 两个选项。

根据文件来源选一条路径。

如果要补 README 或少量配置文本，选择 Create a new file；如果已有本地文件，选择 Upload file。新仓库应当优先准备 README，用它说明模型的用途、来源、限制和使用条件。不要一上来就堆放一堆没有说明的权重文件，那样以后维护起来会很头疼。

菜单选择后应该切换到相应页面。

Upload file 进入上传页，Create a new file 进入在线编辑页。看不到 Add file 时，确认当前是否位于自己的仓库，而不是其他公开模型页，并且检查账号是否有写入权限。

上传文件并留下可读的提交记录

上传页从 Add file 菜单进入。

选择 Upload file 后，顶部是文件拖放区，下方是 Commit changes 区域。

先放文件，再写提交说明。

把文件拖入上传区，或者点击浏览并选择本地文件。文件进入列表后，填写能说明本次修改的提交标题；如果确实有背景信息需要交代，再写扩展说明。团队协作需要审阅时，根据组织流程决定是否勾选 Open as a pull request。

提交前观察按钮和文件列表。

文件名已经出现，Commit changes 按钮可用，提交后返回 Files 页面并看到新文件。按钮不可用时，检查文件是否成功进入上传区、提交标题是否为空。上传中断后，先查看文件列表和提交历史，不要立刻重复选择同一文件——很可能文件已经传上去了。

创建结果核对

正常的模型仓库会在 Files 页面列出 README、配置或模型文件，并在 History 区域显示提交次数。大文件可能带有 LFS 标记，它表示文件由大文件存储机制管理，不等于上传失败，别被吓到。

• 左上角 Owner 和仓库名与创建表单一致。
• Public 或 Private 符合预期，没有把未公开内容放进公开仓库。
• Model card 或 Files 页面能够打开，首个文件已经出现在列表中。
• History 的提交次数增加，提交标题能说明本次修改。
• 仓库中没有访问令牌、密钥、个人信息或无权公开的数据。

这五项都能确认后，模型仓库的创建流程才算真正闭环。后续再根据模型类型补充 README、配置和权重文件，会比一开始无说明地堆文件更容易维护，也更能体现专业度。