Workshop Parallel Jupyter

Quick Start

This workshop uses a modern Python environment managed with uv. To get started:

1. Install uv (if not already installed):

   curl -LsSf https://astral.sh/uv/install.sh | sh

2. Set up the environment:

   uv sync

3. Test the environment:

   uv run python scripts/test_environment.py

4. Start Jupyter:

   uv run jupyter lab

Environment Testing

The environment is automatically tested via GitHub Actions whenever dependencies change. You can also test locally:

• Test all imports: uv run python scripts/test_environment.py
• Verify notebooks: All notebooks are automatically validated for syntax

Prerequisites

Participants must have already completed these basics:

• Functioning user account on bwUniCluster, i.e.
  • bwIDM entitlement 'bwUniCluster' of your home institution
  • Account created on https://bwidm.scc.kit.edu
  • One-time password (OTP) set up on this website under Service->My Tokens
  • One-time SSH access to ssh [email protected]
  • Completing the mandatory questionnaire.
• For later practice: X11 access, i.e.
  • under Windows a putty with X11 forwarding
  • or a WSL2 installation with X11, e.g. https://x410.dev/