Installing Miniconda and Jupyter

This guide explains how to install Miniconda and JupyterLab on Windows, macOS, and Linux.

Miniconda is a minimal Python distribution containing Python, the conda package/environment manager, and a small set of basic packages. Jupyter is not included by default, so we will install it into a separate conda environment.

The links below use Anaconda's latest aliases. This means that they should continue to point to the newest available Miniconda installer without requiring this tutorial to be updated for every release.

All available installers can also be found here:

Official Miniconda installer directory

Important: Intel Macs are now a legacy platform for Anaconda/Miniconda. The Intel installer remains available, but new Intel macOS builds are no longer produced. Most Macs sold since late 2020 use Apple Silicon.

1. Download the Windows x86-64 installer from the link above.
2. Double-click the downloaded .exe file.
3. Select Just Me when asked who should receive the installation.
4. Keep the default installation directory unless you have a reason to change it.
5. On the Advanced Installation Options screen:
   • keep Create shortcuts enabled;
   • do not enable Add Miniconda3 to my PATH environment variable;
   • keeping Register Miniconda3 as my default Python enabled is normally fine on a fresh computer.
6. Finish the installation.

Open the Windows Start menu and search for Anaconda Prompt.

You should see (base) at the beginning of the prompt.

Run:

conda --version
python --version

If both commands print version numbers, Miniconda is installed correctly.

If you want to use normal PowerShell instead of Anaconda Prompt, run this once from Anaconda Prompt:

conda init powershell

Then close and reopen PowerShell.

Most Macs sold since late 2020 use Apple Silicon.

You can check the processor in Apple menu → About This Mac, or open Terminal and run:

uname -m

Possible results:

• arm64 → Apple Silicon → use the MacOSX-arm64 installer.
• x86_64 → Intel Mac → use the MacOSX-x86_64 installer.

1. Download the appropriate .pkg installer from the table above.
2. Open it and follow the installation wizard.
3. When installation has finished, close and reopen Terminal.

Verify the installation:

conda --version
python --version

If conda is not found, initialize it manually. A standard user installation is usually located in ~/miniconda3:

~/miniconda3/bin/conda init zsh
source ~/.zshrc

Open a terminal and run:

uname -m

Usually you will see one of these:

• x86_64 → standard Intel/AMD PC → use Linux-x86_64.
• aarch64 or arm64 → ARM64 machine → use Linux-aarch64.

Download the appropriate .sh installer from the table above. It will normally be saved in ~/Downloads.

For a normal Intel/AMD Linux computer:

cd ~/Downloads
bash Miniconda3-latest-Linux-x86_64.sh

For an ARM64 Linux computer:

cd ~/Downloads
bash Miniconda3-latest-Linux-aarch64.sh

During installation:

1. press Enter to read the license;
2. type yes to accept it;
3. press Enter to accept the default installation location;
4. answer yes when asked whether conda should initialize your shell.

After installation, close and reopen the terminal.

Alternatively, refresh the current terminal:

For Bash:

source ~/.bashrc

For Zsh:

source ~/.zshrc

Verify the installation:

conda --version
python --version

The following steps are the same on Windows, macOS, and Linux.

<note> It is good practice not to install course packages directly into the base environment. Instead, we create a separate environment for Jupyter and the packages used in the course. </note>

Create an environment named jupyter containing Python 3.13, JupyterLab, and the Python kernel:

conda create -n jupyter -c conda-forge --override-channels python=3.13 jupyterlab ipykernel

When conda asks whether to continue, type:

y

Activate the environment:

conda activate jupyter

Your terminal prompt should now begin with something similar to:

(jupyter)

Activate the environment if it is not already active:

conda activate jupyter

Navigate to the directory in which you want to work.

For example, on macOS/Linux:

cd ~/Documents

On Windows:

cd %USERPROFILE%\Documents

Start JupyterLab:

jupyter lab

JupyterLab should open automatically in your web browser.

<note> Do not close the terminal window while JupyterLab is running. The Jupyter server runs in this terminal. </note>

In JupyterLab:

1. click File → New → Notebook or select the Python notebook launcher;
2. create a new cell;
3. enter:

print("Jupyter is working!")
 
import sys
print(sys.version)
print(sys.executable)

Run the cell with Shift + Enter.

If the output is displayed without an error, the installation is working.

Return to the terminal in which JupyterLab is running and press:

Ctrl+C

If asked whether you want to shut down the server, confirm with y.

Every time you want to use this environment:

conda activate jupyter
jupyter lab

To leave the environment:

conda deactivate

Activate the environment first:

conda activate jupyter

For example, to install NumPy, pandas, SciPy, and Matplotlib from conda-forge:

conda install -c conda-forge --override-channels numpy pandas scipy matplotlib

For packages that are not available through conda, use pip only after activating the correct conda environment:

python -m pip install PACKAGE_NAME

First close and reopen the terminal.

On macOS with Zsh:

~/miniconda3/bin/conda init zsh
source ~/.zshrc

On Linux with Bash:

~/miniconda3/bin/conda init bash
source ~/.bashrc

On Windows, open Anaconda Prompt from the Start menu instead of a normal Command Prompt.

Check that the jupyter environment is active before starting JupyterLab:

conda activate jupyter
jupyter lab

You can check which Python executable is currently being used with:

python -c "import sys; print(sys.executable)"

• Miniconda installation documentation
• Official Miniconda installer archive
• Project Jupyter installation documentation
• Conda documentation