search

windowsWindows

To work on the assignments, you need a UNIX-like environment. Luckily, even though Windows is not UNIX-based, the Windows Subsystem for Linux (WSL) allows you to run a Linux distribution in a virtual machine (VM) with minimal setup.

circle-info

If you already have WSL installed, make sure you have the Ubuntu 24.04 version installed. Otherwise, the framework might not work as intended.

hashtag
Step 1: Install PyCharm

Download and install PyCharmarrow-up-right for Windows. We strongly recommend installing the Professional version of PyCharm (free of cost). To do this, you will need to create an account using your university student email address. You may also use the Community edition, however we do not oficially support it.

hashtag
Step 2: Install WSL

  1. Open PowerShell as administrator.

  2. Enter wsl --install (This step may take a few minutes)

  3. When prompted choose a username and password for the WSL user account.

WSL should now be installed and the PowerShell window will show the command line for the Linux VM. From now on, you can enter this Linux VM by opening the WSL App from within Windows (e.g., by typing "WSL" in the search bar).

circle-exclamation

Any terminal commands that are mentioned in the following guides should be executed in a WSL terminal - not your Windows command line.

hashtag
Step 3: Install Miniconda3

mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm ~/miniconda3/miniconda.sh

After installing, close and reopen your terminal application or refresh it by running the following command:

hashtag
Step 4: Set up SSH with GitHub

One of the easiest ways to access your GitHub account (and with that your private repository) from within WSL is to set up a Secure Shell (SSH) key. Follow the GitHub SSH Setup Guide for this. Make sure to execute all commands from within your WSL terminal!

hashtag
Step 5: Set up PyCharm with WSL

  1. Follow the Framework Setup section to create your conda environment.

  2. Click the Python Interpreter selectorarrow-up-right and choose Add New Interpreter.

  3. Select On WSL.

  4. Wait until PyCharm detects Linux on your machine and completes introspection. Click Next to proceed:

PreviousLinuxNextMacOS

Last updated