Skip to main content

Command Line Interface (CLI) Reference

Use the merry binary to manage, customize, compile, and execute models on your terminal shell.

Command Reference​

merry serve​

Start the background daemon. This listens to incoming API requests from other developer tools or SDKs.

  • Flags:
    • None (controlled via environment variables).

merry run​

Retrieve a model configuration and open an interactive terminal chat session.

  • Usage: merry run <model_name> [prompt]
  • Examples:
    • merry run llama4
    • merry run deepseek "What is the capital of France?"
  • Flags:
    • --format json: Format model completion responses in strict JSON format.
    • --keepalive <duration>: Specify how long to keep the model weights cached in memory (e.g. 10m or 2h, defaults to 5m).

merry pull​

Pull a model tag from the registry to your local storage cache without starting execution.

  • Usage: merry pull <model_name>
  • Example: merry pull mistral

merry push​

Push a customized local model tag to a remote registry hub.

  • Usage: merry push <username>/<model_name>
  • Example: merry push developer1/custom-llama

merry create​

Compile and create a customized model configuration by parsing a local Modelfile.

  • Usage: merry create <model_name> -f <path_to_modelfile>
  • Example: merry create my-custom-agent -f ./Modelfile
  • Flags:
    • -f, --file: Path to the target Modelfile configuration file.

merry list​

List all model configurations stored in your local registry cache directory.

  • Usage: merry list
$ merry list
NAME                    ID              SIZE      MODIFIED
gemma4:latest           a8f8c7e9b23b    4.7 GB    2 hours ago
llama4:8b               b3a1b024b898    4.7 GB    Yesterday
deepseek-v3:latest      c3a1b024b898    120 GB    3 days ago

merry ps​

Inspect which models are currently loaded in VRAM/RAM and active on execution boundaries.

  • Usage: merry ps
$ merry ps
NAME             ID              SIZE      PROCESSOR    UNTIL
gemma4:latest    a8f8c7e9b23b    4.7 GB    GPU          4 minutes from now

merry show​

Display structural parameter metadata, system prompts, templates, and licensing agreements for a specific model tag.

  • Usage: merry show <model_name>
  • Flags:
    • --license: Display only the model licensing tags.
    • --system: Print only the configured system instruction text.
    • --template: Output only the model prompt template structure.

merry cp​

Clone or rename an existing model configuration tag.

  • Usage: merry cp <source_model> <target_name>
  • Example: merry cp llama4 my-llama-clone

merry rm​

Delete a model tag and purge its cached weights from local disk space.

  • Usage: merry rm <model_name>
  • Example: merry rm deepseek-v3