---

title: 'Spice.ai OSS Installation' sidebar_label: 'Installation' sidebar_position: 0 description: 'Instructions for installing Spice.ai OSS' pagination_next: null

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

Installation options for Spice.ai OSS

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

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

### Homebrew

```bash
brew install spiceai/spiceai/spice
```

```bash
iex ((New-Object System.Net.WebClient).DownloadString("https://install.spiceai.org/Install.ps1"))
```

Direct Download

Binaries for Linux, Windows, and macOS are available for download from GitHub at github.com/spiceai/spiceai/releases.

Building Spice from Source

Build prerequisites

```shell
# 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 shell xcode-select --install

3. Install dependencies shell brew install rust brew install go brew install cmake brew install protobuf

2. Install Go shell 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 shell curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y # install unattended source $HOME/.cargo/env

Build Spice OSS

Build with Hardware Acceleration

Spice OSS supports running both local language models and embedding models on dedicated hardware. This is for models from either Huggingface or models located locally.

The Spice CLI will automatically detect and download the appropriate runtime binary with hardware acceleration if available.

CUDA Support

Steps:

1. GPUs with Cuda compute capabilities < 7.5 are not supported (V100, Titan V, GTX 1000 series, ...).
2. Ensure both Cuda and associated Nvidia drivers are installed. Requires CUDA version 12.2 or higher
3. Ensure Nvidia binaries are in your path:

1. Build Spice OSS with CUDA support:

This ensures CUDA devices are selected on model load, and CUDA-specifiy kernels used when possible.

Metal Support

Steps:

1. Ensure you have Xcode installed.

1. Build Spice OSS with Metal support:

Similarily, this ensures Metal devices are selected on model load, and Metal-specific kernels used when possible.