Installing
==========

System Requirements
-------------------

py2FaceR was written on a Windows 7 machine running Python 2.7, so the author
knows that it at least *should* work on there.
py2FaceR should however work on any machine running Python 2.7. If it works on
your machine please e-mail me so I can update these docs.

At the very least you need to install these manually:

#. Python 2.7 (http://python.org/download/)
#. PIL - Python Image Library (http://www.pythonware.com/products/pil/)
   Please just save yourself some frustration and install this one directly. It
   can be a real pain to install the PIL library from the command line.

PIP or easy_install
-------------------
Pip is the preferred method of doing the install, but easy_install will work 
too.

Once those Python and PIL are installed you can run ``pip install py2facer``
You may have to give the full path to pip (assuming you do the default install
on Windows it should be in `c:\Python27\Scripts\pip.exe`).

Okay now what
-------------

py2facer.py should be installed in your Scripts directory, so for example
``c:\Python27\python.exe c:\Python27\Scripts\py2facer.py`` should output
some help text. The rest of the details are in :doc:`running`