Installing imageio
==================

Imageio is written in pure Python, so installation is easy. 
Imageio works on Python `2.7 <drop27.html>`_ and 3.4+. It also works on Pypy.
Imageio depends on Numpy and Pillow. For some formats, imageio needs
additional libraries/executables (e.g. ffmpeg), which imageio helps you
download and store in a folder in your application data.

To install imageio, use one of the following methods:
    
* If you are in a conda env: ``conda install -c conda-forge imageio``
* If you have pip: ``pip install imageio``
* Good old ``python setup.py install``

After installation, checkout the
:doc:`examples  <examples>` and :doc:`user api <userapi>`. 


Developers
----------

For developers, we provide a simple mechanism to allow importing 
imageio from the cloned repository. See the file ``imageio.proxy.py`` for
details.

Further imageio has the following dev-dependencies:

``pip install black pytest pytest-cov sphinx numpydoc``
