文档

模型 (model.yaml)

发布 model.yaml

将您的模型定义上传到 LM Studio Hub。

通过将 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.yamlREADME 和其他元数据文件。重要的是,这不会下载模型权重。

终端
$ 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

本页的源文件可在 GitHub 上获取