Installation

Willow supports Python 3.8+. It is a pure Python library with no hard dependencies so it doesn’t require a C compiler for a basic installation.

Installation using pip

pip install Willow

Installing underlying libraries

In order for most features of Willow to work, you need to install either Pillow or Wand. You can follow the installation instructions for each of them:

• Pillow installation

• Wand installation

or you can install them together with Willow when using pip:

pip install Willow[Pillow]
# or
pip install Willow[Wand]

Note that Pillow doesn’t support animated GIFs and Wand isn’t as fast. Installing both will give best results.

HEIC and AVIF support

When using Pillow, you need to install pillow-heif for AVIF and HEIC support:

pip install pillow-heif
# or
pip install Willow[heif]

When using Wand, you will need ImageMagick version 7.0.25 or newer.

Both Pillow and Wand require libheif to be installed on your system for full HEIC support.