Step 1: Install anaconda (if not already done)

Ensure that conda on the system path. It is recommended to download miniconda.

Step 2: Create the GTDB-Tk environment


It is strongly recommended to create a new GTDB-Tk environment for each version of GTDB-Tk released.

GTDB-Tk package requires third-party packages from the conda-forge and bioconda channels.

# latest version
conda create -n gtdbtk -c conda-forge -c bioconda gtdbtk

# specific version (replace 1.3.0 with the version you wish to install, recommended)
conda create -n gtdbtk-1.3.0 -c conda-forge -c bioconda gtdbtk=1.3.0

Step 3: Download and alias the GTDB-Tk reference data

GTDB-Tk requires an environment variable named GTDBTK_DATA_PATH to be set to the directory containing the unarchived GTDB-Tk reference data.


The conda package is bundled with a script (located here) that will automatically download, and extract the GTDB-Tk reference data. The script will be on the system path so simply run:


You can automatically alias GTDBTK_DATA_PATH whenever the environment is activated by editing {gtdbtk environment path}/etc/conda/activate.d/, e.g.:

# Determine the GTDB-Tk environment path
conda activate gtdbtk-1.3.0
which gtdbtk
# /miniconda3/envs/gtdbtk-1.3.0/bin/gtdbtk

# Edit the activate file
echo "export GTDBTK_DATA_PATH=/path/to/release/package/" > /miniconda3/envs/gtdbtk-1.3.0/etc/conda/activate.d/