A. Murat Eren (Meren)

Table of Contents

This is petty old now, and we will not add new OS X installers. Please do not use this, and try Homebrew installation instructions you can find in this post.

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

One of our highest priorities with anvi’o has always been the ease of use. Pain-free installation is clearly an important requirement to achieve that. Installing anvi’o is not terribly hard, however, there is still room for improvement.

We now have a new installer, and if you are using Mac OS X (version 10.9+, i.e., Maverick or Yosemite), you are pretty much covered!

The only thing you need to do is to download the installer on your MAC computer, and install anvi’o with one double-click and one drag gesture with your mouse.

Download the installer (v2.0.2)

You can download the latest version of the installer using the download link (it is on the bottom right corner):

Install anvi’o

Double-click on the installer. You should be welcomed by this screen:

Drag the anvi’o logo into the Applications folder.

Run the test.

Before I continue, I would first like to invite you to install iTerm 2 on your Mac if you are not already using it. It is a Terminal replacement, and it is much more talented than the default terminal application on OS X systems. If iTerm 2 is installed on your computer, anvi’o will happily start in an iTerm 2 window (otherwise it will fall back to the ugly Terminal). Please see FAQ down below if you have a different terminal application.

Once the installation is completed, click the anvi’o logo in your Applications folder. This should open a terminal window.

If your MAC does not open the application due to your security settings, you may need to do the following just for once: open your Applications folder, find anvi’o icon (right-click on it), and select Open from the right-click menu. Once you have done it, you can start anvi’o just like any other application.

To run the default test, simply type this command:


This should do a bunch of things, and if everything is in order, your browser should pop-up, and you should be able to see this display when you click the ‘Draw’ button:

Do you see it? Now you can follow the user tutorial if you like.

Thank you for giving it a try.

Older versions


Is there a way to start anvi’o in any terminal window?

Yes! Just copy-paste this line into any terminal window you are working in:

source /Applications/Anvio.app/Contents/Resources/Scripts/activate.sh

Even better, you can add an anvio alias in your shell, so you can invoke the platform anytime from your terminal by typing anvio. Run this command line on your terminal, and start a new terminal to test whether anvio alias is working for you:

echo 'alias anvio="source /Applications/Anvio.app/Contents/Resources/Scripts/activate.sh"' >> ~/.bash_profile

Now it is installed on my MAC, am I good to go with my analyses?

Yes you can do that, but I would urge you to get your system administrator to have it installed on your server as well –everything they may need to install anvi’o on a server system is explained here, and we would be very interested to answer any further questions. If you have anvi’o installed on your personal computer as well as on your server computer, you can do compute-intensive tasks (such as profiling, merging multiple profiles, or automatic genome binning) on the server, and download the results and visualize them, or perform human-guided genome binning on your computer using the interactive interface.

Who is responsible for this installer?

OK. I wasn’t going to mention it to not embarrass him, but since you asked, I have no other option but to tell you that Özcan Esen spent a couple of sleepless nights to create the initial version of this installer.