Before your workshop

Laptop setup, done before Day 1.

Pick your workshop for the step-by-step guide. It takes about 20 minutes and one command does most of it.

You need
  • A laptop or desktop (not a phone or tablet)
  • Windows 10/11 (64-bit) or macOS 12+ (Linux works too)
  • At least 4 GB RAM (8 GB+ recommended; 16 GB for workshops with Docker labs)
  • About 5 GB of free disk space
  • Permission to install software (on office laptops, ask IT or use the cloud backup)
  • Stable internet for the installation (a mobile hotspot is fine)
Troubleshooting

Fixes for common problems

Windows: "running scripts is disabled on this system"

Open PowerShell and run Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, answer Y, then run the installer again.

"winget is not recognized" (Windows)

Install App Installer from the Microsoft Store, restart PowerShell and run the installer again.

"code", "git" or "uv" not found right after installing

Close all terminals and VS Code and open them again (new commands appear after a restart). Still missing? Restart the laptop and run the installer once more.

Mac: "install command line tools" pop-up

Click Install, wait until it finishes, then run the installer again.

Jupyter: no kernel, or ".venv" not in the list

In VS Code press Ctrl+Shift+P (Mac: Cmd+Shift+P) → Python: Select Interpreter → choose .venv. Reopen the notebook and pick the kernel again. No .venv? Run uv sync in the lab folder.

vp check says packages are missing

In the lab folder run uv sync, then uv run vp check.

AI access key rejected

Copy the key again from WhatsApp (no spaces) and run uv run vp setup. Still rejected? Reply Need help on WhatsApp.

GitHub sign-in keeps looping

In VS Code: Accounts icon (bottom left) → Sign in with GitHub → allow in the browser. On an office laptop, try your personal browser profile.

Office or college network blocks downloads

Use a mobile hotspot for the installation, or use the Codespaces backup.

Antivirus blocks the installer

Allow it once, or install VS Code and Git manually from code.visualstudio.com and git-scm.com, then run the installer again.

"No space left on device"

Free at least 5 GB of disk space and run the installer again.

Laptop has 4 GB RAM and feels slow

Close other apps and browser tabs during the workshop. Docker labs run better in the Codespaces backup.

Docker: "WSL 2 is not installed" or "virtualization disabled"

In an admin PowerShell run wsl --install and restart. If virtualization is disabled in BIOS, use the Codespaces backup.

Still stuck? WhatsApp "Need help"