Setup

The SDK is currently available via source distribution. We use Poetry for robust dependency management and packaging.

Prerequisites

• Python: Version 3.13 or newer is required.
• Poetry: For package management.

Install Poetry

If you do not have Poetry installed, use the official installer:

curl -sSL https://install.python-poetry.org | python3 -

Ensure the poetry binary is in your path by verifying the version:

poetry --version

Install SDK

Clone the repository and navigate to the SDK directory:

cd mosaico/mosaico-sdk-py

Install the dependencies. This will automatically create a virtual environment and install all required libraries (PyArrow, NumPy, ROSBags, etc.):

poetry install

Activate Environment

You can spawn a shell within the configured virtual environment to work interactively:

eval $(poetry env activate)

Alternatively, you can run one-off commands without activating the shell:

poetry run python any_script.py