spiceai/docs

title: 'chat' sidebar_label: 'chat' pagination_prev: null pagination_next: null description: 'spice chat CLI documentation'

Start an interactive or one-shot chat with a model (opens in a new tab) registered in the Spice runtime.

--model, -m Target model for the chat request. When omitted, the CLI uses the single ready model or prompts for a choice if several models are ready.
--temperature <float> Model temperature used for chat request.
--endpoint <endpoint> Specifies the remote Spice instance HTTP endpoint (e.g., http://localhost:8090).
--headers <KEY:VALUE> Custom HTTP headers in format Key:Value (can be specified multiple times).
--output <format>, -o Output format: table (default) or json.

When exactly one model is ready, spice chat opens a REPL that uses that model automatically:

When multiple models are ready, the command prompts for a selection before starting the REPL:

Passing --model skips the prompt and directs the request to the specified model. The flag works both in REPL mode and in one‑shot mode:

Single prompt: