Installation#

The last stable release is available on PyPI and can be installed with pip:

$ pip install pywaffle

Requirements

  • Python 3.9+

  • Matplotlib 3.6+

Matplotlib is installed automatically with PyWaffle.

Drawing with icons

Icons come from Font Awesome, which is an optional dependency. Install it alongside PyWaffle if you want pictogram charts:

$ pip install "pywaffle[icons]"

Everything except the icons parameter works without it, including characters, which uses an ordinary font. Passing icons without the extra raises ImportError with the command to run.

A copy of Font Awesome already installed on the system can be used instead of the Python package. See Font Awesome Integration.