Installing Python and JupyterLab

Last updated on 2026-10-05 | Edit this page

Estimated time: 30 minutes

Overview

Questions

  • How do I install Python?
  • How do I launch JupyterLab?

Objectives

  • Download and install Python.
  • Install the JupyterLab, Pandas, and Matplotlib packages.
  • Organize folders and files on your computer.
  • Create a folder to hold the Jupyter notebooks you will create during this workshop series.

Getting Started with Python


In this activity, you will install Python to your personal computer. You only need to install and configure Python once for this workshop, so future lessons will assume that you already have Python installed.

JupyterLab is an application developed by Project Jupyter that enables one to working with Jupyter notebooks, text editors, terminals, and even custom components in a flexible, integrated, and extensible manner.

Installing Python


The easiest way to install Python and JupyterLab will depend on your operating system.

Caution

If you encounter an error during the installation process, please flag down an assistant, ask a question over Zoom, or contact your instructor through Canvas if you are working asynchronously.

Installing Python: MacOS


Before installing Python on a Mac, you will need to know the type of processor it has.

Depending on when you bought your laptop, your Mac may have an Apple Silicon chip or an Intel chip. For Python to work correctly, you must install the version that corresponds to your laptop’s chip.

Finding Your Processor Chip Type

  1. Click on the Apple icon in the top left corner of your screen.
  2. Select About this Mac.
  3. Look at the line labeled Chip.
  • If your chip name begins with Apple, it is an Apple Silicon processor.
  • If your chip name begins with Intel, it is an Intel processor.

Apple Silicon Chip

Downloading Python

To make installation faster and easier, you will be downloading Python through an environment management tool called Miniconda.

Go to the Anaconda/Miniconda download page.

Miniconda Download

From the Miniconda column, select the Graphical installer download that corresponds to your chip type.

For example, if you have a Mac with an Apple Silicon chip, you should select the 64-Bit (Apple silicon) Graphical Installer.

Double-click to download the file to your computer.

Installing Miniconda

Once the download has completed, double-click the Miniconda .pkg file in your Downloads folder.

A graphical installer will launch.

Installation Screen

Press Continue to navigate through the installer. Click Agree to the terms of the End User License Agreement.

When prompted to select a destination for your Python installation, select “Install for all users of this computer”.

This will install Miniconda (and Python) to your computer. Click Continue.

Select a Destination

When prompted, click Install.

Install Prompt

Wait while Miniconda installs. This should take fewer than 5 minutes.

Installation Completed

When the installation has finished, close the installer window by clicking Close.

Installing JupyterLab

Look for the magnifying glass icon in the top right corner of your screen. Search for Terminal and click the icon to launch the Terminal application.

Terminal search

The Terminal (or command line) is a special application that allows you to talk to software on your computer through textual commands. Some applications can only be accessed through the command line.

Type the command conda install jupyterlab pandas matplotlib and press the Enter key.

Mac terminal

You may be prompted to press the a key twice, followed by the y key. The required software for this workshop will be downloaded from the internet.

Conda Command finished

When you see your username followed by a blinking cursor, that means that the terminal is waiting for another command. You are ready to launch JupyterLab.

Launching JupyterLab

JupyterLab Launch

Congratulations! You’ve installed JupyterLab. You will not need to perform these installation steps again.

Now, and in the future you can launch Juptyer Lab by doing the following:

  1. Search for Terminal.
  2. Open Terminal.
  3. Type jupyter lab inside the terminal and press the Enter key.

JupyterLab will launch in a new tab in your default web browser.

JupyterLab at Launch

Installing Python: Windows


Downloading Python for Windows

To make installation faster and easier, you will be downloading Python through an environment management tool called Miniconda.

Go to the Anaconda/Miniconda download page.

Installation Screen

Click the Miniconda link to download the file to your computer.

Installing Miniconda

Locate the downloaded file (likely in your Downloads folder if you did not specify a location) to start the installation process. Double-click it.

You will see an installer like this open.

Miniconda Installer

Click Next to proceed to the next screen of the installer.

Read through Miniconda’s End User License Agreement (EULA) and click I Agree to agree to the terms.

You will be prompted to select for which users Miniconda should be installed, either

  • Just Me (Recommended)
  • All Users

Miniconda Installation Type

Select Just Me and click Next.

Next, you will be prompted to select where Miniconda should be installed. The default location, in your home directory, is appropriate.

Miniconda Installation Location

When asked about Advanced Installation Options make sure to check:

  • Create shortcuts
  • Register Miniconda3 as my default Python.

Leave the other boxes unchecked.

Miniconda Advanced Installation Options

Click Install to install Miniconda. This should take less than five minutes.

Miniconda Installation Complete

When the application has finished installing, click Next.

Miniconda Close Installer

You will reach a final screen. Uncheck both boxes (you can read up on Miniconda later) and click Finish.

Installing JupyterLab

Click the symbol on the bottom of your screen or press the Windows ⊞ key on your keyboard. This will open up the Windows Start Menu.

In the Search box, type Anaconda Prompt. You should see a result like this:

Anaconda Search Result

Click Pin to taskbar, as you’ll need this later.

Now, click on the Anaconda Prompt icon. A new window with a black screen will open.

Anaconda Prompt

Inside the prompt window, type conda install jupyterlab pandas matplotlib and press the Enter key.

You may be prompted to press the a key twice, followed by the y key. The required software for this workshop will be downloaded from the internet.

Installation Finished

After the installation finishes, you will see a message like the one above. Congratulations, you have installed Python and JupyterLab!

Launching JupyterLab

In the future, you can launch JupyterLab with the following steps:

  1. Open Anaconda Prompt.
  2. Type jupyter lab inside the prompt window and press the Enter key.

JupyterLab Launch

JupyterLab will launch in a new tab in your default web browser.

JupyterLab at Launch

The JupyterLab Interface


JupyterLab has many features found in traditional integrated development environments (IDEs) but is focused on providing flexible building blocks for interactive, exploratory computing.

The JupyterLab Interface consists of the Menu Bar, a collapsible Left Side Bar, and the Main Work Area which contains tabs of documents and activities.

The Menu Bar at the top of JupyterLab has the top-level menus that expose various actions available in JupyterLab along with their keyboard shortcuts (where applicable).

A screenshot of the default Menu Bar is provided below.

JupyterLab Menu Bar

Main Work Area

The main work area in JupyterLab enables you to arrange documents (notebooks, text files, etc.) and other activities (terminals, code consoles, etc.) into panels of tabs that can be resized or subdivided. A screenshot of the default Main Work Area is provided below.

If you do not see the Launcher tab, click the blue plus sign under the File and Edit menus and it will appear.

JupyterLab Main Work Area

  • By default, the left sidebar of a Jupyter notebook has a file browser showing the contents of the folder where JupyterLab was launched.

The directory where the JupyterLab server was launched will function as your working directory. This matters because if you want to reference other data files in your code, JupyterLab will look for them here by default. A screenshot of the default Left Side Bar is provided below.

JupyterLab Left Side Bar

The left sidebar can be collapsed or expanded by selecting “Show Left Sidebar” in the View menu or by clicking on the active sidebar tab.

  1. Click on view in the menu bar. This opens a drop down menu of options. Select “File Browser”

    Show File Browser in Menu

  2. When you click on File Browser, this will open the file directory as shown above.
Callout

What is a Working Directory?

  • The working directory is, unless you specify otherwise, the location on your computer’s filesystem where Python will look for files you want to load and where it will put any files you save.
  • You will write your code in Jupyter Notebooks, and save them later in a folder.
  • It’s a good idea to save your data files in a named subfolder, separate from your code. In this workshop your data files will be in .csv format.

Create a Folder for This Workshop


When you run the command jupyter lab in Terminal (MacOS) or Anaconda Prompt (Windows), JupyterLab will launch in your home directory.

Inside your Documents or Desktop folder, create a new folder named PythonWorkshop.

Create PythonWorkshop folder

  • First, click on your Documents folder in the File Browser on the left.
    • You should now see the contents of your Documents or My Documents folder.
  • Next to the blue plus button at the top left of the File Browser, you will see a folder icon.
    • Click the New Folder icon.
    • Name your new folder PythonWorkshop.

Navigate to that folder in the JupyterLab File Browser by clicking on it. You will use this folder in all future workshop sessions.

Create and Save a Jupyter Notebook File to your Working Directory


In the central pane of the JupyterLab interface, click on Python 3 in the Launcher to create a new Jupyter Notebook:

Launch a New Python3 Notebook

Use the menu or save icon to save this blank notebook. Make sure to name it something helpful. For example, PythonWorkshop_1 or PythonDay1. Notice that JupyterLab will append .ipynb to the end of the name of the notebook. This is the file extension for Jupyter Notebooks.

In the future, you can open your notebooks by navigating to the PythonWorkshop folder through the File Browser pane in JupyterLab.

You can see (and modify) this folder in File Explorer (Windows) or Finder (MacOS) too. Note that you cannot open your Python notebooks (.ipynb) by clicking on them from File Explorer or Finder. You must open them through the JupyterLab File Browser.

Verify your Working Directory


You can verify that you have the correct working directory by using what’s called a magic command.

Use the %pwd magic command within a code cell to print the current working directory. The output will display the current directory path.

Print Working Directory from within Python

This magic command passes the “print working directory” command to your computer. Learn more about pwd here.

Your working directory path should end with PythonWorkshop, the name of your project directory for this workshop.

Key Points

  • JupyterLab is an application for running, managing, and organizing Python code in files called Jupyter notebooks.
  • You will only need to install JupyterLab once for this workshop.
  • Your working directory determines where programs are run and how filepaths are interpreted.