Stable release

To install the latest stable release of Heron you can use pip:

$ pip install heron

This should always install the latest stable release of heron, though it may still be sensible to run this command inside a virtual environment.

If you don’t have pip installed, this Python installation guide can guide you through the process.

Source installation

Alternatively, if you want to make your own changes to the code, or test code between releases you can install from source. The Heron source can be downloads from the Github repo.

You can either clone the public repository:

$ git clone git://

Or download the tarball:

$ curl  -OL

Once you have a copy of the source, you can install it with:

$ python install