# Install

You can try sqldash before installing it. `uvx` runs it from uv's cache and fetches
Python 3.11 or newer for it if your machine doesn't have one.

```bash
uvx sqldash init --demo
uvx sqldash serve
```

<div class="steps">

### Install the CLI

```bash
uv tool install sqldash                          # recommended
uv tool install 'sqldash[snowflake]'             # with the driver for your warehouse
uv tool install 'sqldash[snowflake,postgres]'    # or several
pip install 'sqldash[snowflake]'                 # pip needs Python 3.11 or newer
```

The base install includes DuckDB, SQLite, the MCP server, and AI Studio, which is
enough for the demo and for any dashboard over local files. Extras work with `uvx` too,
as in `uvx --from 'sqldash[snowflake]' sqldash serve`.

### Pick your warehouse driver

Each warehouse driver is an optional extra, so you only install what you use.

| extra | enables |
| --- | --- |
| `postgres` | Postgres |
| `snowflake` | Snowflake with SSO, password, PAT, or key pair auth |
| `bigquery` | BigQuery |
| `redshift` | Redshift |
| `databricks` | Databricks |
| `athena` | Athena |
| `mysql` | MySQL and MariaDB |
| `trino` | Trino |
| `clickhouse` | ClickHouse |
| `lookml` | `sqldash import lookml` |
| `snapshot` | `sqldash snapshot` for static PNG renders, plus a one-time browser download described in [Snapshots](/docs/snapshots/) |
| `all` | everything above, which pulls every driver and is heavy for CI |

> [!NOTE]
> DuckDB and SQLite need no extra. SQL Server needs `pyodbc` and an ODBC driver on the
> machine. See [Sources](/docs/sources/) for how to configure each one. When a dashboard
> needs a driver you have not installed, `sqldash lint` names the extra to add.

### Check it works

```bash
sqldash --version
sqldash init --demo /tmp/sqldash-demo && sqldash serve /tmp/sqldash-demo
```

The demo dashboard should open at `http://127.0.0.1:8400`. When it does, run
[Setup](/docs/setup/) to connect your own warehouse.

</div>