OSX set up Python (Anaconda): Difference between revisions

Latest revision as of 03:43, 28 March 2023

Download and install Python[edit]

We're going to be installing Python using a software collection that includes Python. The 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[edit]

Try to download the installer from either of these places:

Download option #2[edit]

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

Installation[edit]

If you are on MacOS 10.15 (Catalina), you must follow an additional step which is noted below. 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.

Make sure you download the version for Python3
Opening the file with Package Installer will guide you through the setup process
You may be prompted for your password
Package Installer will install Anaconda3

Install notes[edit]

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.

Test your Python install[edit]

To use Anaconda on MacOS, you will primarily use the Anaconda Navigator; It lets you manage the installed python tools, create custom setups, and launch tools like 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:

One of the options (it's the middle option in the screenshot) should be called "Jupyter Notebook". Click that to open Jupyter Notebook! After a few seconds, you'll see a new tab open in your default browser. It will look something like this:

Your default browser is where you'll be working with Jupyter Notebooks.

If for some reason you don't see something in your browser, let a mentor know.

When you launched the notebook from Anaconda, you may have noticed a Terminal window popped up, like this:

You can hide it, but do not close it during the whole time when you are using the Jupyter Notebook. If you close it, your Jupyter Notebook will be closed automatically.

To close Anaconda, first go to your terminal, then, press "CONTROL+C" keys, you will see a new line on your terminal:

Press "y" key, then press "RETURN" key. Now your Anaconda is closed :)

Now Anaconda is not running on your terminal. You can press the "x" on the upper left corner of your terminal window to close the terminal as well.

Success! You've gotten Anaconda and Python working on your Mac!

Success![edit]

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

@@ Line 1: / Line 1: @@
 == 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'''.
+We're going to be installing Python using a software collection that includes Python. The 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'''.
-<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>
+'''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.
-If that 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 for Windows" section.
+=== Download option #1 ===
-Make sure you selected the Python 3.7 option, as Python 2.7 behaves differently and isn't what we use in this course. If you get an error about not being able to run that software on your computer, talk to me.
+<font size="+1">Try to download the installer from either of these places:</font>
-Once the program is downloaded, run the downloaded file which should launch a graphical installer.
+* [https://repo.anaconda.com/archive/Anaconda3-2023.03-MacOSX-x86_64.pkg This file which contains Anaconda and Python 3.10 for MacOS for Intel-based Macs]
+* [https://repo.anaconda.com/archive/Anaconda3-2023.03-MacOSX-arm64.pkg This file which contains Anaconda and Python 3.10 for MacOS for the newer M1 Macs]
+=== Download option #2 ===
+If option 1 above doesn't work for any reason, download the Python 3.10 option from [https://www.anaconda.com/distribution/#download-section Anaconda's website]. If necessary, scroll down to the "macOS Installer" section.
+=== Installation ===
+{{Notice|If you are on MacOS 10.15 (Catalina), '''you must follow an additional step''' which is noted below. 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>
+file:Macos-anaconda-37.png|Make sure you download the version for Python3|alt=Dialog box confirming that the downloaded file is called "Anaconda3-2019-MacOSX-x86_64.pkg
+file:Macos-anaconda-hello.png|Opening the file with Package Installer will guide you through the setup process|alt=Package Installer window greeting the user
+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
+</gallery>
 === Install notes ===
@@ Line 15: / Line 32: @@
 *If you get stuck during the install process, ask a neighbor or raise your hand for help. [http://docs.continuum.io/anaconda/install.html#mac-install These instructions] may also be helpful.
-*Anaconda may leave a shortcut called "Launcher" on your desktop. You can delete this link: we won't be using it in the workshop.
+* 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.
+[[File:Macos-anaconda-self-delete.png|thumb|none|200px|Prompt from Package Installer asking if it is OK to trash the installation package.]]
+== Test your Python install ==
+To use Anaconda on MacOS, you will primarily use the Anaconda Navigator; It lets you manage the installed python tools, create custom setups, and launch tools like Jupyter.
+The easiest way to launch the Anaconda Navigator is from inside the Applications folder:
+[[File:Macos-anaconda-navigator.png|200px]]
+The navigator will start up and greet you with a list of installed and available tools:
+[[File:Macos-anaconda-nav-hub.png|frameless|400px]]
+One of the options (it's the middle option in the screenshot) should be called "Jupyter Notebook". Click that to open Jupyter Notebook! After a few seconds, you'll see a new tab open in your default browser. It will look something like this:
+[[File:Jupyternb launch.png|500px]]
+Your default browser is where you'll be working with Jupyter Notebooks.
+If for some reason you '''don't''' see something in your browser, let a mentor know.
+When you launched the notebook from Anaconda, you may have noticed a Terminal window popped up, like this:
+[[File:Terminal.png|500px]]
+You can hide it, but do not close it during the whole time when you are using the Jupyter Notebook. If you close it, your Jupyter Notebook will be closed automatically.
+To close Anaconda, first go to your terminal, then, press "CONTROL+C" keys, you will see a new line on your terminal:
+[[File:Shutdownline.png]]
+Press "y" key, then press "RETURN" key. Now your Anaconda is closed :)
+Now Anaconda is not running on your terminal. You can press the "x" on the upper left corner of your terminal window to close the terminal as well.
-== Test your Python install {{tbd}} ==
+<!--
+From the left hand side, choose '''Environments''', then choose the small "play" button. A menu will appear; choose the option 'Open with Python'. This will open an interactive Python window that we're going to use to test Python out with.
-{{notice|This section needs to updated so that it walks through the process of opening up A Jupyter notebook in Mac OSX after a fresh Anaconda install and then exist it. Ideally with screenshots as per [[Windows set up Python (Anaconda)]].}}
+[[File:Macos-anaconda-environments.png|frameless|400px]]
-== Success! ==
+Enter into the window '''print("Hello, World!")'''. You should see the text '''"Hello, World!"''' echoed back at you.
+Enter into the window '''<tt>exit()</tt>''' and you'll shut down the Python session and get a helpful '''<tt>[Process Completed]</tt>''' from the terminal, telling you your session is over.
+[[File:Macos-conda-python-hello.png|frameless|400px]]
+Press '''Command-Q''' or choose '''Terminal > Quit Terminal''' from the menu to close Terminal.
-You have tested your Python installation.
+-->
-== Alternative Installation Instructions ==
+Success! You've gotten Anaconda and Python working on your Mac!
-If the installation above fails, you can follow these instructions instead:
+== Success! ==
-* Download and install the [http://continuum.io/downloads Anaconda] that includes Python 3.7:
+You have installed and configured Python. You can move on to the next step.
-*# First, visit the [http://continuum.io/downloads Anaconda download page].
-*# Click the blue text to the right side of the penguin logo that says "'''I WANT PYTHON 3.7'''".
-*# Click on top button on the right side of the same box under the text "'''CHOOSE YOUR INSTALLER'''". The button should say something like '''MAC OS X 64-bit Python 3.7 Graphical Installer'''.
-# Once the (~275 MB) installer package is downloaded, double click the .pkg file and follow the instructions on the screen. Install Anaconda in your home folder.
 [[Category:CDSW]]