lhc models

Manage Lakehousecat custom models. Custom models combine a provider base model with your datasources.

Commands

models list

lhc models list [--type <type>] [--limit N] [--offset N]

Flag	Default	Description
--type	—	Filter by model type: chat, embedding, text-to-speech, speech-to-text
--limit	50	Maximum number of models
--offset	0	Pagination offset

---

models get <id>

lhc models get <model-id>

---

models create

Create a new custom model:

lhc models create \
  --id <model-id> \
  --name <display-name> \
  --base-model-id <base-model-id> \
  [--type chat]

Flag	Required	Default	Description
--id	yes	—	Unique identifier (no spaces)
--name	yes	—	Display name shown in the UI
--base-model-id	yes	—	ID of the provider base model
--type	no	chat	Model type

Use lhc models list to find available --base-model-id values.

---

models update <id>

Rename a custom model:

lhc models update <model-id> --name "New Name"

---

models delete <id>

lhc models delete <model-id>

---

models set-default <id>

Set a model as the default for its type. This controls which model is pre-selected in new sessions:

lhc models set-default <model-id> --type chat

Flag	Required	Description
--type	yes	Model type: chat, embedding, text-to-speech, speech-to-text

---

models export <id>

Export a custom model definition to a portable .lhc.json file. Embedded datasource references are included:

# Print to stdout
lhc models export <model-id>

# Write to file
lhc models export <model-id> -f model.lhc.json

Flag	Description
-f, --output-file	Write output to this file (default: stdout)

---

models import <file>

Import a model from a .lhc.json export file:

lhc models import model.lhc.json [--name <override-name>]

Flag	Description
--name	Override the model name from the export file

If a model with the same name or ID already exists, the import is aborted with an HTTP 409 error and instructions for resolution.