Workshop

ngio Workshop

Hands-on notebooks for learning the basics of ngio.

Locally

The notebooks are self-contained and manage their own dependencies. You only need uv installed.

On Unix-like systems (Linux, macOS):

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

and, on Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Then clone the repository and launch a notebook:

git clone https://github.com/BioVisionCenter/ngio-workshop.git
cd ngio-workshop
uvx marimo edit --sandbox notebooks/<notebook>.py

On first run uv creates an isolated environment and installs dependencies. This takes a minute; subsequent runs are instant.

In the cloud

Click the Open in molab badge next to any notebook below to run it in your browser via molab. No local setup required — a free account is needed to execute cells.

Heads up: if a molab tab sits idle for a long time, or you navigate away and back, you may see errors. Close the tab and reopen the notebook.

Follow along

The notebooks below link to a static read-only version — no account needed, but you won't be able to modify or execute cells.