In order to make use of the PyMedPhys library, you’ll need Python installed on your workstation. Although not essential, we recommend that you install the Anaconda Python distribution which is an open source, optimized Python (and R) distrubution. Download the latest Anaconda Python 3 (not 2) version from here.


When installing Anaconda make sure to install it for your user only, and tick the option “add to path”.


Once you have a suitable Python installation, you can install the latest stable version of PyMedPhys via conda or pip as described in the following sections.

Installing via pip from PyPI

Alternatively, you can install via pip as follows:

pip install pymedphys

Note that issues with some of PyMedPhys’ dependencies may arise if you choose to install via this method.

Setting up a development environment

To set up a development environment please follow the Developer Guide. That guide provides specific details for Windows users, but similar steps work on macOS and Linux also.

Installing the “bleeding edge” version from GitHub

You can install the very latest, “bleeding edge”, development version of PyMedPhys, but you will first need Git and Yarn. You can find instructions for installing Git here and Yarn here.

Once you have Git and Yarn, run the following commands in a terminal to clone the pymedphys GitHub repo and install the pymedphys package along with its dependencies:

git clone
cd pymedphys
yarn bootstrap

Windows users can find detailed instructions for installing Git and Yarn in the Developer Guide.