Installationļ
Note
This is an Augur-specific installation guide. If you wish to use Nextstrain as a whole, please refer to the Nextstrain installation guide.
Install Augurļ
Warning
There are some package managers that have entries with a similar name.
Augur on PyPI. This is a different project. Use nextstrain-augur instead.
augur on Debian. This is an unofficial version not maintained by the Nextstrain core team. It may lag behind official Augur releases. We do not generally recommend its use.
There are several ways to install Augur, ordered from least to most complex.
Augur is part of the Nextstrain project and is available in all Nextstrain runtimes.
Continue by following the Nextstrain installation guide.
Once installed, you can use nextstrain shell to run augur directly.
Augur can be installed using Conda or another variant. This assumes you are familiar with how to manage Conda environments.
conda install -c conda-forge -c bioconda augur
This installs Augur along with all dependencies.
Warning
Installing other Python packages after Augur may cause dependency incompatibilities. If this happens, re-install Augur using the command in step 1.
Augur is written in Python 3 and requires at least Python 3.10. Itās published on PyPI as nextstrain-augur.
Install Augur along with Python dependencies.
python3 -m pip install nextstrain-augur
Install other dependencies.
Augur uses some external bioinformatics programs that are not available on PyPI:
augur alignrequires mafftaugur treerequires at least one of:augur mergerequiressqlite3(the SQLite CLI (version ā„3.39)) for metadata and SeqKit for sequences.Bacterial data (or any VCF usage) requires vcftools
If you use Conda, you can install them in an active environment:
conda install -c conda-forge -c bioconda mafft raxml fasttree iqtree vcftools seqkit sqlite --yes
On macOS using Homebrew:
brew tap brewsci/bio brew install mafft iqtree raxml fasttree vcftools seqkit sqlite
On Debian/Ubuntu:
sudo apt install mafft iqtree raxml fasttree vcftools seqkit sqlite3
Other Linux distributions will likely have the same packages available, although the names may differ slightly.
Warning
Installing other Python packages after Augur may cause dependency incompatibilities. If this happens, re-install Augur using the command in step 1.
Augur can be installed from source. This is useful if you want to use unreleased changes. To develop Augur locally, see instructions in the āDevelopmentā tab.
Install Augur along with Python dependencies.
git clone https://github.com/nextstrain/augur.git cd augur python3 -m pip install .
Install other dependencies.
Augur uses some external bioinformatics programs that are not available on PyPI:
augur alignrequires mafftaugur treerequires at least one of:augur mergerequiressqlite3(the SQLite CLI (version ā„3.39)) for metadata and SeqKit for sequences.Bacterial data (or any VCF usage) requires vcftools
If you use Conda, you can install them in an active environment:
conda install -c conda-forge -c bioconda mafft raxml fasttree iqtree vcftools seqkit sqlite --yes
On macOS using Homebrew:
brew tap brewsci/bio brew install mafft iqtree raxml fasttree vcftools seqkit sqlite
On Debian/Ubuntu:
sudo apt install mafft iqtree raxml fasttree vcftools seqkit sqlite3
Other Linux distributions will likely have the same packages available, although the names may differ slightly.
Warning
Installing other Python packages after Augur may cause dependency incompatibilities. If this happens, re-create the environment from scratch.
Install non-Python dependencies. The instructions below are for conda.
NAME=augur conda env create -n "$NAME" -f dev_env.yml
Activate the new environment.
conda activate "$NAME"
Install Augur along with Python dependencies.
git clone https://github.com/nextstrain/augur.git cd augur python3 -m pip install -e .'[dev]'
Testing if it workedļ
If installation worked, you should be able to run augur --help and see augurās primary help output.