.. highlight:: shell

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

Stable release

To install Face Recognition, run this command in your terminal:

.. code-block:: console

$ pip3 install face_recognition

This is the preferred method to install Face Recognition, as it will always install the most recent stable release.

If you don't have pip_ installed, this Python installation guide_ can guide you through the process.

.. _pip: https://pip.pypa.io .. _Python installation guide: http://docs.python-guide.org/en/latest/starting/installation/

From sources

The sources for Face Recognition can be downloaded from the Github repo_.

You can either clone the public repository:

.. code-block:: console

$ git clone git://github.com/ageitgey/face_recognition

Or download the tarball_:

.. code-block:: console

$ curl  -OL https://github.com/ageitgey/face_recognition/tarball/master

Once you have a copy of the source, you can install it with:

.. code-block:: console

$ python setup.py install

.. _Github repo: https://github.com/ageitgey/face_recognition .. _tarball: https://github.com/ageitgey/face_recognition/tarball/master