Install directions

This section covers the basics of how to download and install TomoPy.

Supported Environments

TomoPy is tested, built, and distributed for python 2.7 3.5 3.6 on Linux/macOS and python 3.5 3.6 on Windows 10.

Common issues

When using pyFFTW instead of MKL-FFT, it is best to import TomoPy before importing NumPy. See this thread for details.

Updating the installation

TomoPy is an active project, so we suggest you update your installation frequently. To update the installation run:

$ conda update -c conda-forge tomopy

For some more information about using Conda, please refer to the docs.

OPTION 2: Installing from source with Conda

Sometimes an adventurous user may want to get the source code, which is always more up-to-date than the one provided by Conda (with more bugs of course!).

For this you need to get the source from the TomoPy repository on GitHub. Download the source to your local computer using git by opening a terminal and running:

$ git clone

in the folder where you want the source code. This will create a folder called tomopy which contains a copy of the source code.

Installing dependencies

You will need to install all the dependencies listed in requirements.txt or meta.yaml files. For example, requirements can be installed using Conda by running:

$ conda install --file requirements.txt

After navigating to inside the tomopy directory, you can install TomoPy by running the install script:

$ pip install .