.. _installation:

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

Installing from `PyPI`_ is recommended.

If you're unfamiliar with Python packaging tools (such as ``pip`` and ``virtualenv``)
see what `The Hitchhiker's Guide to Python`_ has to say about them.


.. code::

    $ pip install laboratory

You can also install a `tagged version`_ from Github

.. code::

    $ pip install https://github.com/joealcorn/laboratory/archive/v1.0.tar.gz

Or the latest development version

.. code::

    $ pip install git+https://github.com/joealcorn/laboratory.git


.. _PyPI: https://pypi.python.org/pypi/laboratory
.. _tagged version: https://github.com/joealcorn/laboratory/releases
.. _The Hitchhiker's Guide to Python: http://docs.python-guide.org/en/latest/dev/virtualenvs/

Now move on to the :ref:`quickstart`