Installing Tropofy on a Unix System

Tropofy runs on all popular UNIX-like systems such as Linux, & MacOS X, as well as on Windows platforms. Tropofy requires Python version 2.7 to run, and does not require the compilation of any C code, so you need only a Python interpreter that meets the requirements mentioned.

Installing Python

You can use your system’s “package manager” to install Python. Every system’s package manager is slightly different, but the “flavor” of them is usually the same.

For example, on an Ubuntu Linux system, to use the system package manager to install a Python 2.7 interpreter, use the following command:

$ sudo apt-get install python2.7-dev

Set Up a Python Virtual Environment

It is best practice to install Tropofy into a “virtual” Python environment in order to obtain isolation from any “system” packages you’ve got installed in your Python version. This can be done by using virtualenv. The steps required to setup Pyhton with a virtual environment are described below,

  1. Install the latest setuptools distribution into the Python you obtained/installed/found in the step above: download and run it using a command prompt:

    $ sudo python
  2. Use the easy_install command to install the virtualenv package:

    $ easy_install virtualenv
  3. Use that Python’s virtualenv to make a workspace:

    $ virtualenv --no-site-packages tropofy_env
  4. Set your terminal to use the virtualenv tropofy_env:

    $ source tropofy_env/bin/activate

Install Tropofy

  1. Install non python dependencies

    (tropofy_env) $ sudo apt-get install libpq-dev
  2. Use pip to get Tropofy and its direct dependencies installed:

    (tropofy_env) $ pip install tropofy


Trouble with installation?

  1. Run pip install tropofy again. Sometimes Pip can be unresponsive for certain packages. Usually trying the installation again will fix the problem.

  2. Are you behind a proxy? In most corporate environments you will access the internet through a proxy. This may interfere with Pip. Use the –proxy command with Pip to get around this (you may have to contact your IT department to get proxy details and authentication info).

    (tropofy_env) $ pip install --proxy=https://proxyAddress:proxyPort tropofy
  3. If problems persist, contact us at