Editing OSX set up Python (Anaconda)
From CommunityData
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
== Download and install Python == | == Download and install Python == | ||
We're going to be installing Python using a software | 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. | '''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. | ||
Line 7: | Line 7: | ||
=== Download option #1 === | === Download option #1 === | ||
<font size="+1">Try to download the installer from | <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> | ||
=== Download option #2 === | === Download option #2 === | ||
If option 1 above doesn't work for any reason, download the Python 3. | 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 === | === Installation === | ||
{{Notice|If you are on MacOS 10.15 (Catalina), '''you must follow an additional step''' | {{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. | To install Anaconda, simply open the package and follow the prompts. You may be asked to enter your password by Package Installer. | ||
Line 35: | 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 == | ||
To use Anaconda on MacOS, you will primarily use the Anaconda Navigator | 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 easiest way to launch the Anaconda Navigator is from inside the Applications folder: | ||
Line 48: | Line 57: | ||
[[File:Macos-anaconda-nav-hub.png|frameless|400px]] | [[File:Macos-anaconda-nav-hub.png|frameless|400px]] | ||
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: | |||
[[File: | [[File:20200112_2.PNG|500px]] | ||
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! == | == Success! == | ||
You have installed and configured Python. You can move on to the next step. | You have installed and configured Python. You can move on to the [[CDSW/Day_0_setup_and_tutorial|next step]]. | ||
[[Category:CDSW]] | [[Category:CDSW]] |