Auspice fork from github of
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
james hadfield 68c746d9c5 rebuild docs 3 years ago
build try a simpler process 5 years ago
cli When converting v1 to v2 JSONs set version to "v2" 3 years ago
docs rebuild docs 3 years ago
docs-src [docs] add documentation around handling of missing data 3 years ago
examples update v2 minimal example JSON 3 years ago
scripts remove images from get-data script 3 years ago
src [bugfix] two trees can now be coloured by date 3 years ago
test Move testing libraries to devDependencies 3 years ago
.editorconfig lint & editor config 6 years ago
.eslintignore proxy requests through dev server to avoid cors for now 6 years ago
.eslintrc update eslint 3 years ago
.gitignore move docusaurus dependency to docs-src sub-repo 3 years ago
.npmignore remove ./src from npmignore 4 years ago
.travis.yml Update release instructions, docs 4 years ago changelog & version bump to 2.0.0 3 years ago
LICENSE.txt Initial commit with license and readme. 6 years ago changelog & version bump to 2.0.0 3 years ago
auspice.js Add `auspice convert` to allow cli v1 -> v2 JSON conversion 3 years ago
babel.config.js Implmement code splitting using lazy loading 3 years ago
favicon.png updated logo 4 years ago
index.html Implmement code splitting using lazy loading 3 years ago
index.js Allow auspice code to be imported via node's `require` 3 years ago
package-lock.json Upgrade eslint-utils for security fixes 3 years ago
package.json changelog & version bump to 2.0.0 3 years ago [docs] include changelog 3 years ago
webpack.config.js allow bundle analysis at build stage 3 years ago

Build Status NPM version License: AGPL v3

Nextstrain is an open-source project to harness the scientific and public health potential of pathogen genome data. We provide a continually-updated view of publicly available data with powerful analytics and visualizations showing pathogen evolution and epidemic spread. Our goal is to aid epidemiological understanding and improve outbreak response.

Resulting data and inferences are available live at the website


Definition: Observation by an augur, ie a prophetic sign.

Auspice is an open-source interactive web app for visualizing phylogenomic data. It may be used in tandem with nextstrain's bioinformatics toolkit augur or on its own. Auspice may be used to explore datasets locally or run as a as a server to share results.


Please see for auspice documentation.


npm install --global auspice

See here for full instructions, including how to install from source.


In order to get up & running you'll need to have some datasets to visualise. Please see the nextstrain docs for tutorials on how to do this. For the purposes of getting auspice up & running you can download the current zika dataset via:

mkdir datasets
curl --compressed -o datasets/zika_meta.json
curl --compressed -o datasets/zika_tree.json

And then run auspice via:

auspice view --datasetDir datasets

This will allow you to run auspice locally (i.e. from your computer) and view the dataset which is behind

Run auspice --help or visit for more information.

Development, comments, issues and bugs

Auspice is developed via GitHub and issues are very welcome. Alternatively, email us with any questions or comments you may have. If you are interested in submitting a pull request please use eslint as much as possible -- thanks!

New versions are released via the ./ script from an up-to-date master branch. It will prompt you for the version number increase, push changes to the release branch and, as long as Travis-CI is successful then a new version will be automatically published to npm.

Please see docs-src/README for how the auspice documentation site is built.

Copyright 2014-2019 Trevor Bedford and Richard Neher.

Source code to Nextstrain is made available under the terms of the GNU Affero General Public License (AGPL). Nextstrain is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.