Installation

Install attaviz from PyPI.

With uv

uv add attaviz

With pip

pip install attaviz

For choropleth maps, install the optional GeoPandas support:

uv add "attaviz[maps]"
# or
pip install "attaviz[maps]"

Keep the extra in quotes so shells do not expand the brackets.

For styled tables powered by Great Tables:

uv add "attaviz[tables]"
# or
pip install "attaviz[tables]"

Install both with pip install "attaviz[maps,tables]".

Requirements

• Python 3.11 or newer
• Altair 5 or newer

Dependencies (altair, pandas, pyarrow, vegafusion, vl-convert-python) install automatically.

Local development

Clone and install the dev environment:

git clone https://github.com/datapartnership/attaviz.git
cd attaviz
uv sync --all-groups

Run the project checks:

uv run pytest -q
uv run ruff check .
uv run ruff format --check .

Install Quarto and just separately, then generate the documentation:

just docs

The command installs the documentation dependency group through uv and builds the site in docs/_site.