fix: remove %%capture from unstable lessons and add Lesson 0

- Remove %%capture Jupyter magic from unstable lesson .md files
  (incompatible with MyST rendering)
- Add Lesson 0 (lesson0_tutorial.md) to the unstable section explaining
  how to set up the virtual environment and install all required
  dependencies (numpy, matplotlib)
- Update unstable/README.md table of contents to include Lesson 0
- Update myst.yml TOC to include lesson0_tutorial.md in the Unstable section
- Update AGENTS.md with MyST compatibility notes regarding %%capture

Author: openhands-agent

AGENTS.md

@@ -91,6 +91,11 @@ This script:
 - Fixes `attachment:` image syntax → plain relative paths
 - Handles both trailing-newline and no-trailing-newline source formats
 
+### MyST Compatibility Notes
+
+- **`%%capture` magic is not supported** in MyST text notebooks. The converter may produce cells containing `%%capture` (a Jupyter magic that suppresses output). These must be removed manually from the generated `.md` files, as MyST does not support this magic and the cell will fail to execute.
+- After regenerating with `convert_to_myst.py`, check all unstable `.md` files for `%%capture` and remove those lines.
+
 ---
 
 ## Building & Testing

myst.yml

@@ -49,6 +49,7 @@ project:
     - title: "Unstable"
       children:
         - file: unstable/README.md
+        - file: unstable/lesson0_tutorial.md
         - file: unstable/lesson1_tutorial.md
         - file: unstable/lesson2_tutorial.md
         - file: unstable/lesson3_tutorial.md

unstable/README.md

@@ -10,6 +10,7 @@ has changed from `.ipynb` to `.md` with `{code-cell}` directives.
 
 | Number | Title and Link | Content |
 |--------|------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| 0 | [](./lesson0_tutorial.md) | Setting up the virtual environment and installing all required dependencies. |
 | 1 | [](./lesson1_tutorial.md) | Basic operations in Python and `numpy` |
 | 2 | [](./lesson2_tutorial.md) | Learn about elements and operations in $\mathbb{R}^n$, $SO(n)$, and $SE(n)$ with $n\in{\{2,3\}}$ related to positions, orientations, and poses, respectively. |
 | 3 | [](./lesson3_tutorial.md) | Learn about the composition of rigid body motion in series to obtain the forward kinematics model of a robotic manipulator. |

unstable/lesson0_tutorial.md

@@ -0,0 +1,117 @@
+---
+kernelspec:
+  name: python3
+  display_name: 'Python 3'
+---
+
+# L0 Setting up the virtual environment
+
+*License: CC-BY-NC-SA 4.0*
+
+*Author: Murilo M. Marinho (murilo.marinho@manchester.ac.uk)*
+
+## Prerequisites for the learner
+This lesson has no prerequisites. It is designed to be the first lesson in the course.
+
+## I found an issue
+Thank you! Please report it at https://github.com/MarinhoLab/OpenExecutableBooksRobotics/issues
+
+# Introduction
+
+Before starting with the lessons, you need to set up a suitable Python environment.
+This lesson guides you through creating a Python virtual environment and installing all the dependencies required for this project.
+
+A **virtual environment** is an isolated Python environment that allows you to install packages without affecting your system-wide Python installation. This ensures reproducibility and avoids dependency conflicts.
+
+# Creating a virtual environment
+
+The recommended approach is to use Python's built-in `venv` module. Open a terminal and run:
+
+```bash
+python3 -m venv venv
+```
+
+This creates a directory called `venv` in your current working directory containing the virtual environment.
+
+# Activating the virtual environment
+
+Before installing packages or running the notebooks, activate the virtual environment:
+
+### Linux / macOS
+```bash
+source venv/bin/activate
+```
+
+### Windows (Command Prompt)
+```cmd
+venv\Scripts\activate.bat
+```
+
+### Windows (PowerShell)
+```powershell
+venv\Scripts\Activate.ps1
+```
+
+Once activated, your shell prompt should display `(venv)` to indicate the virtual environment is active.
+
+# Installing the required packages
+
+All lessons in this project use the following core dependencies:
+
+- **numpy**: Numerical computing library for arrays, matrices, and linear algebra operations.
+- **matplotlib**: Plotting library used in later lessons for visualisation.
+
+Run the following command to install them:
+
+```bash
+pip install numpy matplotlib
+```
+
+# Verifying the installation
+
+You can verify that the packages are correctly installed by running the cell below.
+
+````{code-cell}
+import numpy as np
+import matplotlib
+import matplotlib.pyplot as plt
+
+print(f'numpy version: {np.__version__}')
+print(f'matplotlib version: {matplotlib.__version__}')
+````
+
+# Building the documentation (optional)
+
+To build the MyST documentation locally, you will also need:
+
+```bash
+pip install mystmd jupyter-server ipykernel
+```
+
+Then, from the repository root, run:
+
+```bash
+myst build --html
+```
+
+This produces the HTML output in `_build/html/`.
+
+# Deactivating the virtual environment
+
+When you are finished working, you can deactivate the virtual environment:
+
+```bash
+deactivate
+```
+
+# Summary
+
+This lesson covered:
+
+- Creating a Python virtual environment using `venv`.
+- Activating and deactivating the virtual environment.
+- Installing the required packages (`numpy` and `matplotlib`).
+- Verifying the installation.
+- Optional: Installing MyST build tools for local documentation builds.
+
+Now you are ready to proceed to [Lesson 1](./lesson1_tutorial.md).

unstable/lesson1_tutorial.md

@@ -183,7 +183,6 @@ print(f't_phi={t_phi}')
 Just in case `numpy` is not already installed, we can install it with the following command. Nothing will happen if the library is already installed.
 
 ````{code-cell}
-%%capture
 %pip install numpy 
 %pip install numpy --break-system-packages
 ````

unstable/lesson2_tutorial.md

@@ -22,7 +22,6 @@ Thank you! Please report it at https://github.com/MarinhoLab/OpenExecutableBooks
 # Installing prerequisites
 
 ````{code-cell}
-%%capture
 %pip install numpy
 %pip install numpy --break-system-packages
 ````

unstable/lesson3_tutorial.md

@@ -7,7 +7,6 @@ kernelspec:
 # Prerequisites
 
 ````{code-cell}
-%%capture
 %pip install numpy
 %pip install numpy --break-system-packages
 ````

unstable/lesson4_tutorial.md

@@ -7,7 +7,6 @@ kernelspec:
 # Package installation
 
 ````{code-cell}
-%%capture
 %pip install numpy
 %pip install numpy --break-system-packages
 ````

unstable/lesson5_exercise_answers.md

@@ -7,7 +7,6 @@ kernelspec:
 # Package installation
 
 ````{code-cell}
-%%capture
 %pip install numpy matplotlib
 %pip install numpy matplotlib --break-system-packages
 ````

unstable/lesson5_tutorial.md

@@ -7,7 +7,6 @@ kernelspec:
 # Package installation
 
 ````{code-cell}
-%%capture
 %pip install numpy matplotlib
 %pip install numpy matplotlib --break-system-packages
 ````