(This is a reminder to myself, and maybe a help for someone else who might be in the same situation as me. The purpose was to be able to lint documentation I’m trying to update for the pip project work.)
Python for Mac OS X. Python comes pre-installed on Mac OS X so it is easy to start using. However, to take advantage of the latest versions of Python, you will need to download and install newer versions alongside the system ones. The easiest way to do that is to install one of the binary installers for OS X from the Python Download page. How to Install pip3 for Python 3 on Mac OS XHow to install pip for Python 3 on Mac OS Xpip3 -versionbrew updatebrew install python3brew uninstall python3sud.
This applies to installing “the latest” Python on Mac OS X 10.15.6.
I’ve used this helpful How-TO. Everything worked until the very end where brew couldn’t create a necessary directory:
(no idea why!)
I reran install python and got:
The solution was to create the /usr/local/Framworks directory manually:
Then change the owner and group to mirror other directories (bernard:admin)
And finally run the brew link command from above:
And then I could start what I wanted to actually do. 🙂
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. This tutorial will include:
With that, let’s get started
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.
2 - Locate your download and double click it.
3 - Click on Continue
4 - Click on Continue
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 important for later. Click on Continue.
6 - Click on Continue to get the License Agreement to appear.
You will need to read and click Agree to the license agreement before clicking on Continue again.
7 - Click on Install
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.
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.
10 - You should get a screen saying the installation has completed. Close the installer and move it to the trash.
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
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.
If you had chosen a Python 2 version of Anaconda, you should get a similar output to the one below.
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.
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.
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.
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.
2 - Use the
cat command to see the contents of the hidden file .bash_profile. Type the following command into your terminal.
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.
If you see more than one Anaconda version, proceed to step 3.
3 - To remove the old version of Anaconda from your .bash_profile use the command below to edit the file using the nano editor.
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.
Save changes by typing Y.
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.
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.