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.

Requirements

• Python 3.9 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 separately, then render the documentation with quarto render docs.