This repository can be cloned to follow the API workshop proposed by Deltablot.

You can open and run notebooks with Jupyter on your computer (option 1) or use Google Colab (option 2).

Note: the commands below assume a GNU/Linux or MacOS operating system. If you are using Windows, it is recommended to ditch it use WSL or Google Colab option, as it doesn't require to install anything locally on your computer.

We will use uv to manage dependencies, see installation instructions: https://github.com/astral-sh/uv?tab=readme-ov-file#installation

# Clone the repository on your computer
git clone https://github.com/elabftw/api-workshop.git

# Get into the folder
cd api-workshop

# Install dependencies with uv
uv sync --frozen

# Start Jupyterlab
uv run jupyter lab

If you have followed the above commands, a new window will have opened in your browser. Select part1-api-workshop-intro.ipynb in the left pane to get started with the workshop.

You can use Google Colab service to open the Jupyter notebooks.

1. Access https://colab.research.google.com/
2. Select GitHub
3. Enter this GitHub URL in the the search bar: elabftw/api-workshop and press enter
4. Select part1-api-workshop-intro.ipynb

• Getting started: https://doc.elabftw.net/api.html
• Api specification documentation: https://doc.elabftw.net/api/v2/
• Python library repository: https://github.com/elabftw/elabapi-python
• HTML documentation: https://doc.elabftw.net/api/elabapi-html/