Installation

svg2mpl requires Python 3.10 or newer.

From PyPI

pip install svg2mpl

This pulls in matplotlib, numpy, and svgpath2mpl.

CSS <style>-block support

Presentation attributes (fill="red") and inline styles (style="fill:red") work out of the box. To also resolve <style> blocks with CSS selectors and specificity, install the optional css extra:

pip install "svg2mpl[css]"

This adds tinycss2 and cssselect2.

With uv

uv add svg2mpl
# with the CSS extra:
uv add "svg2mpl[css]"

From source

git clone https://github.com/tkclam/svg2mpl
cd svg2mpl
uv sync --extra css

To build the documentation locally, sync the docs dependency group and serve it with live reload:

uv sync --group docs --extra css
uv run mkdocs serve

Verify the install

import svg2mpl

print(svg2mpl.__version__)