Getting started: “How do I download this pipeline?”

Table of contents

  1. Prerequisites
    1. Core Requirements
    2. Options for running the pipeline
    3. Optional but recommended
  2. Installation
    1. 1. Install Nextflow
    2. 2. Install a Container engine (recommended)
    3. 3. Install gitGit
  3. Running the Pipeline
    1. Using nextflow run
      1. A. From Cloned Repository
      2. B. Directly from github
  4. Updating the pipeline

Prerequisites

Before running the BactiSeq pipeline, ensure you have the following installed:

Core Requirements

Software Minimum Version Installation Guide
Java 8 or higher OpenJDK or sudo apt install openjdk-11-jre
Nextflow 22.10.0 See installation methods below

Options for running the pipeline

The pipeline has been tested thoroughly with Singularity

  • Docker or Singularity - for containerized execution
  • Conda/Mamba - for dependency management
  • Git - for cloning the repository

Installation

1. Install Nextflow

Nextflow’s official download and setup page

Nextflow’s Docker installation guide
Singularity Official Documentation

3. Install gitGit

Official Git Documentation

Running the Pipeline

Using nextflow run

The nextflow run command is the primary way to execute Nextflow pipelines. You have several options:

A. From Cloned Repository

The BactiSeq pipeline is hosted on GitHub at sylvial-00/bactiseq. You need to clone it first:

# Clone the repository to your local machine
git clone https://github.com/sylvial-00/bactiseq.git
# Navigate to your cloned pipeline directory
cd bactiseq

# Run the pipeline
nextflow run main.nf -profile docker or singularity --input samplesheet.csv

# Or specify the config file explicitly
nextflow run -c nextflow.config --input samplesheet.csv

B. Directly from github

nextflow run https://github.com/sylvial-00/bactiseq --input samplesheet.csv

Updating the pipeline

# Navigate to your pipeline directory
cd /path/to/bactiseq

# Pull the latest changes from GitHub
git pull origin main

# If you're on a different branch
git pull origin develop  # or other branch name

# Then run with updates
nextflow run main.nf --profile docker --input samplesheet.csv

Flexible, portable and reproducible whole bacterial genome analysis pipeline

This site uses Just the Docs, a documentation theme for Jekyll.