LxMLS 2025

Machine Learning toolkit for Natural Language Processing.
Written for LxMLS - Lisbon Machine Learning Summer School

• Scientific Python and Mathematical background
• Linear Classifiers (Gradient Descent)
• Feed-forward models in deep learning (Backpropagation)
• Sequence models in deep learning
• Attention Models (Transformers)
• Multimodal Models

Instructions for Students

Download the code. If you are used to git just clone the student branch. For example from the command line in do

git clone https://github.com/LxMLS/lxmls-toolkit.git lxmls-toolkit-student
cd lxmls-toolkit-student
git checkout student

Install uv

Linux and MacOS

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

Windows
Open Command Prompt (search for cmd) to run the following commands.

First, check if your system has git using

If git isn't installed run the following command to install it

Then, install uv using

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

If that errors out, try

winget install astral-sh.uv

Set up environment

Reference
If you do not have the proper python version, install it with

If you have an Nvidia GPU, get the CUDA driver version with nvidia-smi or nvcc --version.

Reference
Choose the torch index based on your system and setup the environment:

uv sync --extra {cpu, cu118, cu124, cu126}

For example, if you're on MacOS you'd use

Activate the virtual environment with

Linux and MacOS

source ./.venv/bin/activate

Windows

Development

Install the ruff linter & ty type-checker with

To run all tests install pytest

and run

pytest -m "not gpu" -n auto

Run tests that are GPU intensive with single worker using