Windows

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.

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


Step 1: Install PyCharm

Download and install PyCharm 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.


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).


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:

source ~/miniconda3/bin/activate

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!


Step 5: Set up PyCharm with WSL

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

  2. Click the Python Interpreter selector 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:

Last updated