[[PageOutline(2-5, Table of Contents, floated)]]

= Installation guide =

== Dependencies ==

Py4bot is entirely written in python, and uses some third-party modules:

 * [https://pypi.python.org/pypi/evdev evdev], for usb devices handling
 * [http://www.numpy.org numpy], for matrix and other maths

== Build source archive ==

If you download the Git version, use the following command at '''Py4bot''' root:

{{{
$ python setup.py sdist
}}}

The archive will be build in the {{{dist/}}} directory.

== Install source archive ==

Once you have a source archive, either build from Git or downloaded from stable version, install the framework with:

{{{
$ pip install <path to>/Py4bot-<version>.tar.gz
}}}

To update the Git version, use, at '''Py4bot''' root:

{{{
$ git pull
}}}

Then, re-build the source archive, as described above.

Finally:

{{{
$ pip uninstall Py4bot
$ pip install <path to>/Py4bot-<version>.tar.gz
}}}