Spice CLI

The Spice CLI manages Spicepods and interacts with the Spice runtime.

Common Commands

Command	Description
`spice init`	Initialize a new Spicepod in current directory
`spice run`	Start the Spice runtime
`spice sql`	Start interactive SQL REPL
`spice chat`	Start chat REPL (requires model configured)
`spice add`	Add a Spicepod dependency
`spice datasets`	List loaded datasets
`spice models`	List loaded models
`spice status`	Show runtime status
`spice refresh`	Refresh an accelerated dataset
`spice version`	Show CLI and runtime version
`spice upgrade`	Upgrade CLI to latest version

Quick Start

# Initialize new app
spice init my_app
cd my_app

# Add a sample dataset
spice add spiceai/quickstart

# Start the runtime
spice run

# In another terminal, query data
spice sql
> SELECT * FROM taxi_trips LIMIT 10;

# Or chat with AI (requires model in spicepod.yaml)
spice chat
> How many trips are in the dataset?

Runtime Endpoints

When running spice run, these endpoints are available:

Endpoint	Default Address
HTTP API	`http://127.0.0.1:8090`
Arrow Flight	`127.0.0.1:50051`
Metrics (Prometheus)	`127.0.0.1:9090`
OpenTelemetry	`127.0.0.1:50052`

spice-cli

Spice CLI

Common Commands

Quick Start

Runtime Endpoints

Documentation