Spice.ai CLI documentation

Detailed documentation on the Spice.ai CLI

The Spice.ai CLI is a set of commands to create and manage Spice.ai pods and interact with the Spice.ai runtime.


The Spice.ai CLI can be installed by:

  • Running curl https://install.spiceai.org | /bin/bash
  • Downloading the binary from GitHub Releases

The spice program will be added to the PATH automatically for bash, fish, and zsh shells.

After installing the Spice.ai CLI for the first time, ensuring you’ve got the correct version by running spice version. The Runtime version is not expected to be shown, as the runtime will be downloaded and installed automatically upon first run.

Getting started

For getting started with Spice.ai using the Spice.ai CLI, see the Getting Started Guide.

Use spice help for all commands and spice [command] --help for more information about a command.

A typical command-line workflow might be as follows:

# Start the runtime
spice run

In another terminal:

# Add a pod
spice add samples/trader
# Re-train
spice train trader

Common commands are:

spice addAdd a pod to spicepods
spice runStarts the Spice.ai runtime
spice trainStarts a pod training run
spice versionShows the Spice.ai CLI and runtime versions
spice helpHelp about any command

See Spice.ai CLI command reference for the full list of available commands.


In v0.1.0-alpha the Spice.ai CLI must be manually updated. This can be done by removing the spice binary and re-running the install script above or manually replacing the binary with a downloaded release. E.g.

rm ~/.spice/bin/spice
curl https://install.spiceai.org | /bin/bash

A future release will support a self-update command, see the Spice.ai roadmap for more details.


The Spice.ai CLI is installed by default to $HOME/.spice/bin/spice and a line added to the shell config, such as .zshrc

It can be uninstalled by deleting the spice binary and removing the PATH addition from the rc file.

Spice.ai CLI command reference

Spice.ai CLI command reference