Install Auspice

Note

This is an Auspice-specific installation guide. If you wish to use Nextstrain as a whole, please refer to the Nextstrain installation guide.

Install dependencies

Auspice is a JavaScript program and requires Node.js to be installed on your system. Refer to engines.node in package.json for currently supported versions.

We recommend using Conda to create an environment with a specific version of Node.js. It’s possible to use other methods, but these are the instructions for Conda:

conda create -c conda-forge --name auspice nodejs=16
conda activate auspice

Install Auspice as a user

npm install --global auspice

If you look at the release notes you can see the changes that have been made to Auspice (see your version of Auspice via auspice --version). To upgrade, you can run

npm update --global auspice

Install Auspice as a developer

This is useful for debugging, modifying the source code, or using an unpublished feature branch.

# grab the GitHub auspice repo
git clone https://github.com/nextstrain/auspice.git
cd auspice

# install dependencies and make `auspice` available globally
npm install --global .

Updating Auspice should only require pulling the new version from GitHub - it shouldn’t require any npm commands. You will, however, have to re-build Auspice whenever the client-related code has changed, via auspice build.

Testing if it worked

If installation worked, you should be able to run auspice --help.