通过将 model.yaml 上传到您在 LM Studio Hub 上的页面来分享便携式模型。

在您将 model.yaml 发布到 LM Studio Hub 后，其他用户可以使用 lms get 下载它。

注意：model.yaml 仅指代元数据。这意味着它不包含实际的模型权重。

快速开始

最简单的入门方法是克隆一个现有模型，对其进行修改，然后运行 lms push。

例如，您可以克隆 Qwen 3 8B 模型

lms clone qwen/qwen3-8b

这将生成 model.yaml、README 和其他元数据文件的本地副本。重要的是，这并不会下载模型权重。

$ ls
README.md     manifest.json    model.yaml    thumbnail.png

将发布者更改为您的用户名

model: 字段的第一部分应该是发布者的用户名。请将其更改为您拥有写入权限的用户或组织的用户名。

- model: qwen/qwen3-8b
+ model: your-user-here/qwen3-8b
base:
  - key: lmstudio-community/qwen3-8b-gguf
    sources:
# ... the rest of the file

登录

通过命令行在 Hub 上进行身份验证

lms login

CLI 会打印一个身份验证 URL。在您批准访问后，会话令牌将保存在本地，以便您可以发布模型。

发布您的模型

在包含 model.yaml 的目录中运行 push 命令

lms push

该命令会打包文件并上传，然后为新版本打印修订号。

发布时覆盖元数据

使用 --overrides 来微调字段而无需编辑文件

lms push --overrides '{"description": "Qwen 3 8B model"}'

下载模型并在 LM Studio 中使用

发布后，模型会出现在 LM Studio Hub 上您的用户或组织资料下。

之后可以使用以下命令下载

lms get my-user/my-model