d2-widget 0.0.1rc1

An AnyWidget for displaying declarative diagrams written in D2

D2 Widget

Bring the power of D2 to Python notebooks.

d2-widget is an AnyWidget for displaying declarative diagrams written in D2.

Installation

pip install d2-widget

or with uv:

uv add d2-widget

Development

We recommend using uv for development. It will automatically manage virtual environments and dependencies for you.

uv run jupyter lab example.ipynb

Alternatively, create and manage your own virtual environment:

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
jupyter lab example.ipynb

The widget front-end code bundles it's JavaScript dependencies. After setting up Python, make sure to install these dependencies locally:

pnpm install

While developing, you can run the following in a separate terminal to automatically rebuild JavaScript as you make changes:

pnpm dev

Open example.ipynb in JupyterLab, VS Code, or your favorite editor to start developing. Changes made in js/ will be reflected in the notebook.