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 Settings in the Qualia dashboard.

Installation

Section titled “Installation”
Terminal window
pip install qualia-sdk

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

Quick Start

Section titled “Quick Start”
from qualia import Qualia


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


# Or use the QUALIA_API_KEY environment variable
client = Qualia()


# List available VLA models
models = client.models.list()
for model in models:
    print(f"{model.id}: {model.name}")
    print(f"  Camera slots: {model.camera_slots}")


# Create a project
project = client.projects.create(name="My Robot Project")
print(f"Created project: {project.project_id}")


# 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])


# Start a finetune job
job = client.finetune.create(
    project_id=project.project_id,
    model_id="lerobot/smolvla_base",
    vla_type="smolvla",
    dataset_version_id=dataset_version_id,
    hours=2.0,
    camera_mappings={"cam_1": "observation.images.top"},
)
print(f"Started job: {job.job_id}")


# Check job status
status = client.finetune.get(job.job_id)
print(f"Status: {status.status}")
print(f"Current phase: {status.current_phase}")


# Cancel a job if needed
result = client.finetune.cancel(job.job_id)

Requirements

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

Next Steps

Section titled “Next Steps”