- name
- spice-cli
- description
- Use the Spice CLI to manage Spicepods and interact with the runtime. Use when asked to "run Spice", "query data", "start the runtime", "use spice commands", or "check spice status".
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 |