import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';
Installation options for Spice.ai OSS
Prerequisites:
wsl --install -d Ubuntu-24.04), then follow the Linux steps. The Spice runtime does not run natively on Windows.curl, used by the install script. Minimal Linux images and containers often don't include it. On Ubuntu or Debian, install it with sudo apt-get install -y curl.For deployment options, such as to Kubernetes, see Deployment (opens in a new tab).
```bash curl https://install.spiceai.org | /bin/bash ``` ### Homebrew ```bash brew install spiceai/spiceai/spice ```
### PowerShell Install Script
```bash
iex ((New-Object System.Net.WebClient).DownloadString("https://install.spiceai.org/Install.ps1"))
```
On macOS, Linux, and WSL, the install script does not use sudo to install the spice CLI into ~/.spice/bin, so it also runs without a terminal, such as in a CI job.
Binaries for Linux, Windows, and macOS are available for download from GitHub at github.com/spiceai/spiceai/releases (opens in a new tab).
Verify the installation:
After installing, verify Spice is installed correctly:
Expected output (the runtime is downloaded on the first spice run):
CLI version: v2.x.x Runtime version: not installed
If the command is not found, the current terminal hasn't picked up the updated PATH yet. Open a new terminal, or add the Spice binary directory to the PATH of the current shell:
On Linux, the install script can add the PATH entry to ~/.profile, which some terminals don't read. If spice still isn't found in new terminals, add the line above to ~/.bashrc (or ~/.zshrc for zsh).
After installing, follow the Getting Started guide (opens in a new tab) to initialize a Spice app, connect to a dataset, and run your first query in under 5 minutes.
To build Spice from source, including CUDA and Metal hardware acceleration options, see CONTRIBUTING.md (opens in a new tab) in the Spice.ai GitHub repository.