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

Python Versions
===============

cliff is being developed under Python 2.7 and tested with Python 3.5.

Dependencies
============

cliff depends on setuptools and its pkg_resources module.

.. _install-basic:

Basic Installation
==================

cliff should be installed into the same site-packages area where the
application and extensions are installed (either a virtualenv or the
global site-packages). You may need administrative privileges to do
that.  The easiest way to install it is using pip_::

  $ pip install cliff

or::

  $ sudo pip install cliff

.. _pip: http://pypi.python.org/pypi/pip

Source Code
===========

The source is hosted on github: https://git.openstack.org/cgit/openstack/cliff

Reporting Bugs
==============

Please report bugs through the github project:
https://bugs.launchpad.net/python-cliff
