Skip to content
Qualia Docs

Overview

The official Python SDK for the Qualia robotics data and VLA platform.

Authentication

Section titled “Authentication”

To use the SDK, you need an API key. Create one in the Qualia dashboard: Settings → Account → API keys. The key names its own account, so no account setting is needed; see Configuration.

Installation

Section titled “Installation”
Terminal window
pip install 'qualia-sdk==0.8.0rc11'


# or with uv
uv pip install 'qualia-sdk==0.8.0rc11'

This deployment runs ahead of the public release, so it needs the matching pre-release wheel — 0.8.0rc11. 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-sdk resolves to the current public release and will be turned away by this deployment.

The native transfer engine behind data upload/download is bundled in the wheel — nothing else to install.

Quick Start

Section titled “Quick Start”

For interactive use, log in with qualia auth login (see Authentication); Qualia() reads that login. Scripts and CI can set QUALIA_API_KEY and QUALIA_BASE_URL instead. Set both together to use the same environment.

from qualia import Qualia


# Initialize the client
client = Qualia(api_key="your-api-key")


# Or use your CLI login or the environment variables above
client = Qualia()


# Upload a local dataset directory
result = client.data.upload("/data/gongsta", name="gongsta")
print(result["dataset_id"], result["episode_count"], result["total_frames"])


# Inspect the exact camera schema of a pinned dataset version
dataset_version_id = "44444444-4444-4444-8444-444444444444"
features = client.data.get_training_features(dataset_version_id)
print([camera.key for camera in features.camera_features])

Requirements

Section titled “Requirements”
  • Python 3.10+
  • httpx
  • pydantic

Next Steps

Section titled “Next Steps”