.. _install:

Installation
============

Pip4Blender is installed exactly like any other Blender add-on, and is distributed
as a single Python file.  The latest release can be downloaded from https://github.com/AO-StreetArt/pip4blender/releases.

.. note:: Users with Blender 2.80 should download the pip4blender.py file from the blender-2.80 branch.
   A new release compatible with Blender 2.80 will be created when the new version of Blender is officially released.

Add-on Install
--------------

From the User Preferences panel, select 'Install Addon from File', and select the
pip4blender.py file.

.. image:: _images/Install.png

Pip Install
-----------

Installing Pip in the Blender environment is also required before the rest of the
functionality of the add-on is accessed.  This can be done by selecting the
'Install Pip in Blender' button, but only needs to be done once for any given
Blender installation.

This might take a few minutes to run, if you want to watch the installation
progress you should run Blender from a terminal.

.. image:: _images/Install_Pip.png