---

title: 'Install Spice.ai OSS' sidebar_label: 'Installation' sidebar_position: 0 description: 'Install Spice.ai OSS on macOS, Linux, Windows, or WSL using the install script, Homebrew, PowerShell, or direct download from GitHub releases.' keywords: [spice.ai, install, installation, macos, linux, windows, wsl, homebrew, download] image: /img/og/spiceai.png pagination_next: null

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

Installation options for Spice.ai OSS

Prerequisites: macOS (Apple Silicon), Linux (x86_64 or aarch64), or Windows 10+/WSL. No other dependencies are required for the pre-built binary.

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.

Verify the installation:

After installing, verify Spice is installed correctly:

Expected output:

CLI version:     1.x.x
Runtime version: 1.x.x

If the command is not found, ensure the Spice binary directory is in your PATH.

What's Next?

After installing, follow the Getting Started guide to initialize a Spice app, connect to a dataset, and run your first query in under 5 minutes.

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

3. Install dependencies

2. Install Rust

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-specific kernels are used when possible.

Metal Support

Steps:

1. Ensure you have Xcode installed.

1. Build Spice OSS with Metal support:

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