Skip to main content
HomeAbout PythonLearn Python

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.

Topics

Learn more about Python

Certification available

Course

Introduction to Python

4 hr
5.4M
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

Mastering the Pandas .explode() Method: A Comprehensive Guide

Learn all you need to know about the pandas .explode() method, covering single and multiple columns, handling nested data, and common pitfalls with practical Python code examples.
Adel Nehme's photo

Adel Nehme

5 min

Python NaN: 4 Ways to Check for Missing Values in Python

Explore 4 ways to detect NaN values in Python, using NumPy and Pandas. Learn key differences between NaN and None to clean and analyze data efficiently.
Adel Nehme's photo

Adel Nehme

5 min

Seaborn Heatmaps: A Guide to Data Visualization

Learn how to create eye-catching Seaborn heatmaps
Joleen Bothma's photo

Joleen Bothma

9 min

Test-Driven Development in Python: A Beginner's Guide

Dive into test-driven development (TDD) with our comprehensive Python tutorial. Learn how to write robust tests before coding with practical examples.
Amina Edmunds's photo

Amina Edmunds

7 min

Exponents in Python: A Comprehensive Guide for Beginners

Master exponents in Python using various methods, from built-in functions to powerful libraries like NumPy, and leverage them in real-world scenarios to gain a deeper understanding.
Satyam Tripathi's photo

Satyam Tripathi

9 min

Python Linked Lists: Tutorial With Examples

Learn everything you need to know about linked lists: when to use them, their types, and implementation in Python.
Natassha Selvaraj's photo

Natassha Selvaraj

9 min

See MoreSee More