Installing anvi'o

Thank you for considering anvi’o. Please click the button below that matches your operating system and follow the instructions. Most people will want to install the latest stable release of anvi’o. However, for current or future developers, or for those who feel adventurous and wish to keep up with the latest updates and fixes to the anvi’o source code, we also have detailed installation instructions to track the development version of anvi’o.

Please join our if you find yourself in need of help related to installation.

Stable version

The latest version of anvi’o is v8. See the release notes.

Use these buttons if you wish to install latest stable release of anvi’o. This version of anvi’o is static and no further changes are going toe be made to this particular release. But it has been well-tested, and will work the vast majority of the time (though occasionally bugs slip past our nets, and if you find one, we would love to hear from you). Most end-users find this version of anvi’o to suit their needs.

MACOS

LINUX

WINDOWS

Development version

Use these buttons if you wish to set up anvio-dev on your computer. By doing so, you will be tracking the active development version of anvi’o. It will bring the latest bug fixes and features from GitHub to your work environment every day, but can also be unstable at times. We sometimes ask our users specifically to install anvio-dev if they are experiencing an issue that we already have fixed after a particular release.

MACOS

LINUX

WINDOWS

We thank Daan Speth, Jarrod Scott, Susheel Bhanu Busi, Mike Lee, Josh Herr, and Titus Brown who kindly invested their time to test the installation instructions on different systems and/or made suggestions to these documents to ensure a smoother installation experience for everyone.

Docker container

You could run anvi’o without a conventional installation using Docker:

Show/hide A docker solution for those who are in a hurry

We do recommend you to install anvi’o on your system, but if you just want to run anvi’o without any installation, you can actually do it within minutes using docker.

The docker solution is very simple, guaranteed to work, and very effective to do quick analyses or visualize anvi’o data currencies from others without having to install anything. A more detailed article on how to run anvi’o in docker is here, but here is a brief set of steps.

Assuming you have docker installed and running on your computer, first pull the container:

docker pull meren/anvio:7

Instead of the version number shown above, you can use ANY version number listed on this Docker Hub page.

This step will take a few minutes and require about 15Gb of disk space. Once it is done, you can run it the following way:

docker run --rm -it -v `pwd`:`pwd` -w `pwd` -p 8080:8080 meren/anvio:7

And that’s it! You are now in a virtual environment that runs anvi’o. You can exit this environment by pressing CTRL+D.

If you wish to do resource demanding analyses, don’t forget to increase the CPU and memory resources allocated for anvi’o using the docker Preferences menu.

If you at some point want to remove all containers and reclaim all the storage space, you can run this after exiting all containers:

docker system prune --force -a

If you find a mistake on this page or would you like to update something in it, please feel free to edit its source by clicking the edit button at the top-right corner (which you will see if you are logged in to GitHub) 😇