Installation

The installation workflow is simple and mostly automatic, and relies entirely on Mamba and Conda

Table of contents

  1. Requirements and setup
  2. Dependencies
    1. 1. Chopper
    2. 2. Pigz
    3. 3. GNU Parallel
    4. 4. Python Dependencies
    5. 5. MAFFT
    6. 6. IQtree
    7. 7. R
    8. 8. Astral
    9. 9. ASAP
    10. 10. BLAST

Requirements and setup

To install the pipeline, you must meet the following requirements:

  • Be on a POSIX or POSIX-like operating system (Ubuntu, Fedora, Debian, CentOS, macOS, etc.)
  • Have mamba and conda installed on your local machine.

If you do not meet these two basic requirements, please adjust to them before installing and running the pipeline.

After verifying these requirements, complete the setup by running:

git clone https://github.com/nhmvienna/AmpliPiper.git
cd AmpliPiper

Now that you are in the pipeline’s directory, run the following command to install it:

bash shell/setup.sh

This will create several conda environments in a subdirectory named envs. The process may take a while (sometimes it can even last hours, depending on your machine setup) and there might be problems. Please check out troubleshooting and, if you cannot find a solution or the problem persists, feel free to flag an issue on GitHub.

Dependencies

nanofilt, python_dependencies, parallel, ASAP, astral, B

These are the conda environments that will be created:

envs/
├── asap
├── astral
├── blast
├── iqtree
├── logs
├── mafft
├── chopper
├── parallel
├── pigz
├── python_dependencies
└── R

Here is the breakdown of the dependencies that are contained within these environemnts:

1. Chopper

  • Dependencies: chopper, pigz

2. Pigz

  • Dependencies: pigz

3. GNU Parallel

  • Dependencies: parallel

4. Python Dependencies

  • Dependencies: python=3.10, matplotlib, biopython, edlib, cairosvg, pymsaviz, ete3, beautifulsoup4, scipy, scikit-learn

5. MAFFT

  • Dependencies: mafft=7.520

6. IQtree

  • Dependencies: iqtree=2.2.5

7. R

  • Dependencies: r-base=4.1.3, bioconductor-ggtree, r-tidyverse, bioconductor-treeio, r-phytools, r-ape, r-treedist, r-reshape2, r-seqinr, r-gridextra, r-stringr

8. Astral

  • Dependencies: astral-tree=5.7.8

9. ASAP

  • Dependencies: asap-v0.1.2-h14c3975_0

10. BLAST

  • Dependencies: blast