Installation instructions

The easiest way to install OpenGHG is using pip, first ensure you have a recent version of Python installed.

Checking your Python installation

OpenGHG is developed and tested on Linux and MacOS, support for Windows is planned.

To install OpenGHG, you first need to install Python >= 3.7. To check if you have Python 3.7 installed type;

python -V

This should print out the version number of the Python you have available. If the version number is 2.x then you must use the python3 command, if this this is the case, try;

python3 -V

and see if you have a Python 3 that has a version number >= 3.7. If so, please use python3 instead of python.

If you don’t have Python >=3.7 installed, then you can install Python either via your package manager if using Linux or Homebrew on MacOS. An alternative for both platforms is anaconda.


Virtual environment

We highly recommend creating a separate virtual environment for openghg. This ensures the correct versions of libraries can be installed without making changes to versions of libraries needed for other projects / programs.

python -m venv /path/to/env/openghg_env
# Activate the environment
source /path/to/env/bin/activate

Clone and install

OpenGHG is currently early in its development process so the only way to install the library is by cloning the repository and installing manually using pip.

git clone
cd openghg
pip install .


For developers please see the Development documentation.