Skip to content
Qualia Docs

Overview

The official Python SDK for the Qualia VLA fine-tuning 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

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}")


# Get dataset image keys for camera mapping
image_keys = client.datasets.get_image_keys("lerobot/pusht")
print(f"Available keys: {image_keys.image_keys}")


# Start a finetune job
job = client.finetune.create(
    project_id=project.project_id,
    model_id="lerobot/smolvla_base",
    vla_type="smolvla",
    dataset_id="lerobot/pusht",
    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”