Installation is via pip:

pip install Augmentor

If you have to use sudo it is recommended that you use the -H flag:

sudo -H pip install Augmentor


Augmentor requires Pillow and tqdm. Note that Pillow is a fork of PIL, but both packages cannot exist simultaneously. Uninstall PIL before installing Pillow.


If you prefer to build the package from source, first clone the repository:

git clone

Then enter the Augmentor directory and build the package:

cd Augmentor
python install

Alternatively you can first run python build followed by python install. This can be useful for debugging.


If you are compiling from source you may need to compile the dependencies also, including Pillow. On Linux this means having libpng (libpng-dev) and zlib (zlib1g-dev) installed.