Installing PICRUSt


Most users will not need to install PICRUSt, but can instead use the online Galaxy version.

PICRUSt is written in python, and has been tested on Mac OS X and Linux systems. To install PICRUSt, first install all of the mandatory requirements, following the instructions on their respective websites. You should then download PICRUSt. You have the choice of downloading either the release version (recommended for most users) or the development version (recommended for users who need access to the latest features, and are willing to tolerate some instability in the code). Next, you will download the large precalculated PICRUSt files and place them in your picrust/data directory. Finally, you’ll install PICRUSt. Each of these steps are detailed below.

Step 1. Install Requirements

Follow the install instructions found on the website of each of the dependencies below to install PICRUSt’s dependencies.


These dependencies are automatically installed with pip install . below:

h5py needs to be installed manually (numpy is also required, but it should be installed automatically with this package):

  • h5py (version 2.7.0)

You can install h5py with this command:

pip install h5py

Rebuilding PICRUSt’s precalculated 16S rRNA OR Genome Predictions (optional)

  • R installed with APE library

Step 2. Download PICRUSt

Release software

The latest release of PICRUSt is picrust-1.1.2.

We recommend the release version of PICRUSt for most users. If you’re not sure whether you want the release or the development version of PICRUSt, you should likely go with the release version.

Development software

Alternatively you can download the latest development version of PICRUSt. You can download the development version of PICRUSt from this link, or using the following command if you have git installed:

git clone git:// picrust

Step 3. Install PICRUSt

After downloading PICRUSt, you’ll need to unzip the file. If you’ve downloaded the release version, do this with the following command:

tar -xzf picrust-1.1.2.tar.gz

You’ll then change into the new picrust-1.1.2 directory as follows:

cd picrust-1.1.2

And finally, you’ll install PICRUSt with the following command:

pip install .

Step 4. Download PICRUSt’s precalculated files

PICRUSt precomputes most of the computationally intensive pipeline so each user can get predictions with less steps. These files are changed whenever there is a new release of the GreenGenes tree and/or a new release of IMG. These files are fairly large and need to be downloaded separately. Also, you only need the version that corresponds to the GreenGenes that you picked OTUs against (see Picking OTUs for use in PICRUSt).

Assuming you will be picking OTUs against the newest version of GreenGenes and want KEGG Ortholog predictions, then the default files will be sufficient. If you picked against an older version of GreenGenes or are interested in different functional predictions (e.g. COGs) then see the complete list of PICRUSt’s Precalculated Files.

You can install the default files automatically by running:

Alternatively, download these files and place them in the data directory where PICRUSt was installed (e.g. if installed in a conda enviroment named “picrust”, place the files in $HOME/miniconda3/envs/picrust/lib/python2.7/site-packages/picrust/data/):