Installation

Install SQLsaber, then confirm that the saber command runs.

Install with uv

If you already have uv:

uv tool install sqlsaber

Install without uv

If you do not have uv, use uvx.sh. One command installs SQLsaber. You do not need uv or Python first.

On macOS and Linux:

curl -LsSf https://uvx.sh/sqlsaber/install.sh | sh

On Windows:

powershell -ExecutionPolicy ByPass -c "irm https://uvx.sh/sqlsaber/install.ps1 | iex"

The script installs uv when it is missing. Then it installs SQLsaber.

Install with pipx

If you already use pipx:

pipx install sqlsaber

Confirm the install

saber --version

You should see a version number.

Add official plugins

Plugins add extra tools to the saber CLI. Pass each plugin package in --with when you run uv tool install. After a uvx.sh install, uv is on your machine. The same commands work.

# Charts in the terminal
uv tool install --with sqlsaber-viz sqlsaber

# Sandboxed notebook analysis
uv tool install --with sqlsaber-notebook sqlsaber

# One-off Python in a remote sandbox
uv tool install --with sqlsaber-sandbox sqlsaber

# All three
uv tool install --with sqlsaber-viz,sqlsaber-notebook,sqlsaber-sandbox sqlsaber

See Plugins for setup and usage.

Upgrade

If you installed with uv or uvx.sh:

uv tool upgrade sqlsaber

If you installed with pipx:

pipx upgrade sqlsaber

Run SQLsaber

saber

On first launch, SQLsaber walks you through a database connection and an API key. Continue in Getting started.