Skip to main content

Installing Anaconda on Mac OS X

This tutorial will demonstrate how you can install Anaconda, a powerful package manager, on your Mac.
Jun 2018  · 7 min read

Anaconda is a package manager, an environment manager, and Python distribution that contains a collection of many open source packages. An installation of Anaconda comes with many packages such as numpy, scikit-learn, scipy, and pandas preinstalled and is also the recommended way to install Jupyter Notebooks.

Graphical Installation of Anaconda

Installing Anaconda using a graphical installer is probably the easiest way to install Anaconda.

1 ‒ Go to the Anaconda Website and choose a Python 3.x graphical installer (A) or a Python 2.x graphical installer (B). If you aren’t sure which Python version you want to install, choose Python 3. Do not choose both. Note: see our installing anaconda on Windows tutorial if you're not on Mac OS.

anaconda python install options

2 - Locate your download and double click it.

locate anaconda download

3 - Click on Continue

anaconda installer trusted source pop up

4 - Click on Continue

anaconda3 installer welcome

5 - Note that when you install Anaconda, it modifies your bash profile with either anaconda3 or anaconda2 depending on what Python version you choose. This can be important for later. Click on Continue.

anaconda installer modifies bash profile information

6 - Click on Continue to get the License Agreement to appear.

anaconda installer license agreement

You will need to read and click Agree to the license agreement before clicking on Continue again.

accept anaconda installer agreement

7 - Click on Install

install anaconda3 page

8 - You’ll be prompted to give your password, which is usually the one that you also use to unlock your Mac when you start it up. After you enter your password, click on Install Software.

password prompt page anaconda installer

9 - Click on Continue. You can install Microsoft Visual Studio Code if you like, but it is not required. It is an Integrated Development Environment. You can learn about Python Integrated Development Environments here.

microsoft visual studio code install

10 - You should get a screen saying the installation has completed. Close the installer and move it to the trash.

anaconda installation was completed successfully screen

Test your Installation

1 - Open a new terminal on your Mac. You can do this by clicking on the Spotlight magnifying glass at the top right of the screen, type “terminal” then click on the terminal icon. Now, type the following command into your terminal

python --version

opening a new terminal on mac

If you had chosen a Python 3 version of Anaconda (like the one in the image above), you will get an output similar to above.

output 1

If you had chosen a Python 2 version of Anaconda, you should get a similar output to the one below.

python --version

output 2

2 - Another good way to test your installation is to try and open a Jupyter Notebook. You can type the command below in your terminal to open a Jupyter Notebook. If the command fails, chances are that Anaconda isn’t in your path. See the next section on Common Issues.

jupyter notebook

The image below shows a Jupyter Notebook in action. Jupyter notebooks contain both code and rich text elements, such as figures, links, and equations. You can learn more about Jupyter Notebooks here.

jupyter notebook in action

Common Issues

The image below shows step 5 of the Graphical Installation of Anaconda from earlier in this tutorial. Notice that when you install Anaconda, it modifies your .bash_profile to put Anaconda in your path.

common issues with anaconda installation

The problem is that sometimes people have installed multiple different versions of Anaconda and consequently they have multiple versions of Anaconda in their path. For example, say a person needs Python 2 and they install a Python 2 version of Anaconda, That same person then finds that they need Python 3, so they install a Python 3 version of Anaconda. The problem is that you really only need 1 version of Anaconda. A lot of people think that is that if you install a Python 2 version of Anaconda, you are stuck with Python 2. Anaconda is also an environment manager and makes it very easy to go back and forth between Python 2 and 3 on a single installation of Anaconda (learn more here).

To see if you have more than 1 version of anaconda installed and to fix it if you do, let’s first look at your .bash_profile.

1 - Open a new terminal and go to your home directory. You can do this by using the command below.

cd ~

2 - Use the cat command to see the contents of the hidden file .bash_profile. Type the following command into your terminal.

cat .bash_profile

You should only see one anaconda version added to your path as you see below, this isn’t a problem for you. Move to the conclusion of the tutorial.

output 3

If you see more than one Anaconda version, proceed to step 3.

output 4

3 - To remove the old version of Anaconda from your .bash_profile use the command below to edit the file using the nano editor.

nano .bash_profile

nano bash profile

From the image above, notice there is a newer Version of Anaconda. Simply remove the older version of Anaconda. Type control + X to exit out of nano.

nano bash profile 2

Save changes by typing Y.

nano bash profile 3

Close that terminal and open a new one. You should be okay now. Keep in mind that this isn’t the only issue you can have when installing Anaconda, but it is a very common issue.

Conclusion

This tutorial provided a quick guide to install Anaconda on Mac as well as dealing with a common installation issue. A graphical install of Anaconda isn’t the only way to install Anaconda as you can Install Anaconda by a Command Line Installer, but it is the easiest. If you aren’t sure what to do after installing Anaconda, here are a few things you can do:

If you any questions or thoughts on the tutorial, feel free to reach out in the comments below or through Twitter.

Learn more about Python

Introduction to Python

Beginner
4 hr
4.8M
Master the basics of data analysis with Python in just four hours. This online course will introduce the Python interface and explore popular packages.
See DetailsRight Arrow
Start Course
See MoreRight Arrow
Related

Precision-Recall Curve in Python Tutorial

Learn how to implement and interpret precision-recall curves in Python and discover how to choose the right threshold to meet your objective.
Vidhi Chugh's photo

Vidhi Chugh

14 min

An Introduction to Hierarchical Clustering in Python

Understand the ins and outs of hierarchical clustering and its implementation in Python
Zoumana Keita 's photo

Zoumana Keita

17 min

Association Rule Mining in Python Tutorial

Uncovering Hidden Patterns in Python with Association Rule Mining
Moez Ali's photo

Moez Ali

14 min

An Introduction to Python Subprocess: Basics and Examples

Explore our step-by-step guide to running external commands using Python's subprocess module, complete with examples.
Moez Ali's photo

Moez Ali

15 min

Setting Up VSCode For Python: A Complete Guide

Experience a simple, fun, and productive way of Python development by learning about VSCode and its extensionsn and features.
Abid Ali Awan's photo

Abid Ali Awan

16 min

GeoPandas Tutorial: An Introduction to Geospatial Analysis

Get started with GeoPandas, one of the most popular Python libraries for geospatial analysis.
Javier Canales Luna's photo

Javier Canales Luna

15 min

See MoreSee More