Start

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.

Terminal

uvx sqldash init --demo
uvx sqldash serve

Install the CLI

Terminal

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
`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 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

Terminal

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 to connect your own warehouse.