Spice.ai OSS Installation

Installation options for Spice.ai OSS

For deployment options, such as to Kubernetes, see Deployment.

macOS, Linux, and WSL

Install Script

curl https://install.spiceai.org | /bin/bash

Homebrew

brew install spiceai/spiceai/spice

Windows

PowerShell Install Script

curl -L "https://install.spiceai.org/Install.ps1" -o Install.ps1 && PowerShell -ExecutionPolicy Bypass -File ./Install.ps1

Direct Download

x86_x64 and ARM binaries for linux, Windows, and macOS are available for download from GitHub at github.com/spiceai/spiceai/releases.

Building Spice from Source

Build prerequisites

macOS

1. If you don't already have it installed, install Homebrew:

# Note: Be sure to follow the steps in the Homebrew installation output to add Homebrew to your PATH.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install the Xcode Command Line tools

  xcode-select --install

3. Install dependencies

brew install rust
brew install go
brew install cmake
brew install protobuf

Linux (Ubuntu)

1. Install system dependencies

sudo apt update
sudo apt install build-essential curl openssl libssl-dev pkg-config protobuf-compiler cmake

2. Install Go

export GO_VERSION="1.22.4"
rm -rf /tmp/spice
mkdir -p /tmp/spice
cd /tmp/spice
wget https://go.dev/dl/go$GO_VERSION.linux-amd64.tar.gz
tar xvfz go$GO_VERSION.linux-amd64.tar.gz
sudo mv ./go /usr/local/go
echo 'export PATH=$PATH:/usr/local/go/bin' >> $HOME/.profile
source $HOME/.profile
cd $HOME
rm -rf /tmp/spice

3. Install Rust

  curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y # install unattended
  source $HOME/.cargo/env

Build Spice OSS

# Clone SpiceAI OSS Repo
git clone https://github.com/spiceai/spiceai.git
cd spiceai

# Build and install OSS project in release mode
make install

# Build and install OSS project in dev mode
make install-dev

# Build and install OSS project with models
make install-with-models

# Also you can specify specific features
SPICED_CUSTOM_FEATURES="postgres sqlite" make install

# Run the following to temporarily add spice to your PATH.
# Add it to the end of your .bashrc or .zshrc to permanently add spice to your PATH.
export PATH="$PATH:$HOME/.spice/bin"