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
Documentation
-
CLI Overview
-
Command Reference