OSX set up Python (Anaconda): Difference between revisions

From CommunityData
(→‎Download and install Python: Add Catalina (change to zsh) specific instructions.)
Line 5: Line 5:
'''Note:''' Even if you already have a version of Python on your computer, we suggest you follow these instructions and download Anaconda. This will help ensure that you can follow along during our in-class activities, and will make it easier for mentors to help you if you get stuck on something.
'''Note:''' Even if you already have a version of Python on your computer, we suggest you follow these instructions and download Anaconda. This will help ensure that you can follow along during our in-class activities, and will make it easier for mentors to help you if you get stuck on something.


=== Installation option #1 ===
=== Download option #1 ===


<font size="+1">Try to download and install Anaconda from [https://communitydata.science/~mako/Anaconda3-2019.10-MacOSX-x86_64.pkg this file which contains Python 3.7 for OSX].</font>
<font size="+1">Try to download the installer from [https://communitydata.science/~mako/Anaconda3-2019.10-MacOSX-x86_64.pkg this file which contains Anaconda and Python 3.7 for MacOS].</font>


=== Installation option #2 ===
=== Download option #2 ===
If option 1 above doesn't work for any reason, download and install the Python 3.7 option from [https://www.anaconda.com/distribution/#download-section Anaconda's website], on the right. If necessary, scroll down to the "Anaconda 2019.10 for macOS Installer" section.  
If option 1 above doesn't work for any reason, download the Python 3.7 option from [https://www.anaconda.com/distribution/#download-section Anaconda's website]. If necessary, scroll down to the "Anaconda 2019.10 for macOS Installer" section.
 
=== Installation ===
 
{{Notice|If you are on MacOS 10.15 (Catalina), '''you must follow an additional step'''. If you don't, Anaconda won't work quite right! }}
 
To install Anaconda, simply open the package and follow the prompts. You may be asked to enter your password by Package Installer.


<gallery>
<gallery>
Line 17: Line 23:
file:Macos-anaconda-auth.png|You may be prompted for your password|alt=Package Installer prompting the user for a password
file:Macos-anaconda-auth.png|You may be prompted for your password|alt=Package Installer prompting the user for a password
File:Macos-anaconda-installing.png|Package Installer will install Anaconda3|alt=Package installer showing progress through the installation
File:Macos-anaconda-installing.png|Package Installer will install Anaconda3|alt=Package installer showing progress through the installation
</gallery>
</gallery>


Line 27: Line 32:


[[File:Macos-anaconda-self-delete.png|thumb|none|200px|Prompt from Package Installer asking if it is OK to trash the installation package.]]
[[File:Macos-anaconda-self-delete.png|thumb|none|200px|Prompt from Package Installer asking if it is OK to trash the installation package.]]
* If you are using MacOS 10.15 (Catalina) or above, you will need to configure the system to recognize Anaconda. To do so, open Terminal.app (either using Command-space or opening '''Applications > Utilities > Terminal.app''' and entering the following:
<nowiki>/opt/anaconda3/bin/conda init zsh
/opt/anaconda3/bin/conda config --set auto_activate_base False
</nowiki>
You should end up with something like this:
[[file:Macos-conda-zsh.png|thumb|none|alt=A terminal window showing the result of configuring Conda and MacOS Catalina.]]
Quit Terminal (either with Command-Q or the menu option '''Terminal > Quit Terminal''').


== Test your Python install ==
== Test your Python install ==

Revision as of 23:11, 15 January 2020

Download and install Python

We're going to be installing Python using a collection of software that includes Python that, as a collection, is called Anaconda. Anaconda includes the Python programming language and a bunch of different pieces of software that are useful for data science and analysis. Although the collection includes all free software, it is put together by a commercial company called Continuum Analytics.

Note: Even if you already have a version of Python on your computer, we suggest you follow these instructions and download Anaconda. This will help ensure that you can follow along during our in-class activities, and will make it easier for mentors to help you if you get stuck on something.

Download option #1

Try to download the installer from this file which contains Anaconda and Python 3.7 for MacOS.

Download option #2

If option 1 above doesn't work for any reason, download the Python 3.7 option from Anaconda's website. If necessary, scroll down to the "Anaconda 2019.10 for macOS Installer" section.

Installation

If you are on MacOS 10.15 (Catalina), you must follow an additional step. If you don't, Anaconda won't work quite right!

To install Anaconda, simply open the package and follow the prompts. You may be asked to enter your password by Package Installer.

Install notes

  • If you get stuck during the install process, ask a neighbor or raise your hand for help. These instructions may also be helpful.
  • At the end of the installer, you may be prompted if you'd like to send the installation package to the trash. Doing so won't damage the installation and will free up ~600MB of disk space on your computer.
Prompt from Package Installer asking if it is OK to trash the installation package.
  • If you are using MacOS 10.15 (Catalina) or above, you will need to configure the system to recognize Anaconda. To do so, open Terminal.app (either using Command-space or opening Applications > Utilities > Terminal.app and entering the following:
/opt/anaconda3/bin/conda init zsh
/opt/anaconda3/bin/conda config --set auto_activate_base False

You should end up with something like this:

A terminal window showing the result of configuring Conda and MacOS Catalina.

Quit Terminal (either with Command-Q or the menu option Terminal > Quit Terminal).

Test your Python install

To use Anaconda on MacOS, you will primarily use the Anaconda Navigator. This software helps manage multiple versions of Anaconda, as well as helps make it easy to launch Jupyter.

The easiest way to launch the Anaconda Navigator is from inside the Applications folder:

The navigator will start up and greet you with a list of installed and available tools:

Find the tile that says "jupyter Notebook" and click "launch".

After a few seconds, you should see a new tab open in your default browser. It will look something like this:

Once you see this window, congratulations! Your software is running and ready to go. If you *don't* see something like this in your browser, let a mentor know and we'll help you figure it out.

Note: An application called "Terminal" may also launch when the browser tab opens. You don't need to do anything with this application right now, but it needs to continue running in the background whenever you are using Anaconda and Jupyter. You can minimize the application window, or just ignore it.

To close Anaconda, click "Quit" on the Jupyter tab in your browser. You can then quit the Anaconda Navigator and Terminal.

Success!

You have installed and configured Python. You can move on to the next step.