Documentation

lmstudio icon
LM Studio Desktop
lmstudio-python
lmstudio-js
lms - CLI Reference

lms push Reference

The lms push command packages the contents of the current directory and uploads it to the LM Studio Hub. You can use it to share presets, plugins, or model.yaml files.

Parameters

--overrides (optional) : string

A JSON string of values to override in the manifest or metadata

--write-revision (optional) : flag

Write the returned revision number to manifest.json

Upload a Plugin, Preset, or model.yaml

Run lms push inside the directory that contains your plugin, preset, or model.yaml file:

  • Navigate to the directory of your plugin, preset, or model.yaml file:
cd path/to/your/directory
  • Run the command:
lms push

The command uploads the artifact and prints the revision number. When used with --write-revision, the revision number is also written to the manifest.json file so you can track revisions in version control.

This command works for presets, plugins, and model.yaml files.

Example Usage with --overrides

You can use the --overrides parameter to modify the metadata before pushing:

lms push --overrides '{"description": "new-description"}'