Skip to content

Introduction

Qualia is a cloud platform for robotics data. Upload ROS 2 MCAP, LeRobot 2.1, or LeRobot v3 sources, curate episodes, and pin immutable, reproducible dataset versions.

These docs cover collecting robot data and curating reproducible datasets:

  1. Data Collection - Record demonstrations using LeRobot and prepare your dataset
  2. Dataset versioning - Freeze an exact, reproducible episode selection
  1. Sign in to your organization’s Qualia dashboard
  2. Upload a dataset and explore its episodes from the dashboard
  3. To use the SDK or API, create an API key in Settings in the dashboard

The qualia CLI wraps the Python SDK and installs it for you, so this is the only install needed for either.

Terminal window
pip install 'qualia-cli==0.2.0rc5'
# or with uv
uv tool install 'qualia-cli==0.2.0rc5' --with 'qualia-sdk==0.7.0rc4'

This deployment runs ahead of the public release, so it needs the matching pre-release wheel — 0.2.0rc5. Pin it rather than upgrading: the upload protocol is negotiated exactly, so the client and the endpoint it talks to have to be the same generation. A plain pip install qualia-cli resolves to the current public release and will be turned away by this deployment.

Then point it at this environment and sign in:

Terminal window
qualia auth login

See the CLI overview for the config file, the --base-url and --token overrides, and what to do when a deployment refuses your client.