Installation¶
To run Sumatra you will need Python installed on your machine. If you are running Linux or OS X, you almost certainly already have it. If you don’t have Python, you can install it from python.org, or install one of the “value-added” distributions aimed at scientific users of Python: Enthought or Python(x,y).
The easiest way to install Sumatra is directly from the Python Package Index (PyPI):
$ pip install sumatra
or:
$ easy_install sumatra
Alternatively, you can download the Sumatra package from either PyPI or the INCF Software Centre and install it as follows:
$ tar xzf Sumatra-0.5.3.tar.gz
$ cd Sumatra-0.5.3
# python setup.py install
The last step may need to be run as root, or using sudo.
Installing Django¶
If you wish to use the web interface, you will also need to install Django. On Linux, you may be able to do this via your package management system: see https://code.djangoproject.com/wiki/Distributions.
Otherwise, it is very easy to install manually: see https://docs.djangoproject.com/en/dev/topics/install/#installing-official-release
You will also need to install the django-tagging and docutils packages, which may be in your package management system, otherwise they can be installed from PyPI:
$ pip install django-tagging
$ pip install docutils
Installing Python bindings for your version control system¶
Sumatra currently supports Mercurial, Subversion, Git and Bazaar. If you are using Subversion, you will need to install the pysvn bindings. Since Mercurial and Bazaar are mostly written in Python, just installing the main Mercurial/Bazaar packages is sufficient. For Git, you need to install the GitPython package.