Skip to content
Qualia Docs

Overview

The official command-line interface for the Qualia VLA fine-tuning platform. Built on the Python SDK.

Installation

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

Authentication

Section titled “Authentication”

Create an API key in Settings in the Qualia dashboard, then run:

Terminal window
qualia auth login

You’ll be prompted for your API key, which is saved to a platform-specific config directory:

  • Linux: ~/.config/qualia/config.toml
  • macOS: ~/Library/Application Support/qualia/config.toml
  • Windows: %APPDATA%\qualia\config.toml

Alternatively, pass the token directly (useful in CI/scripts):

Terminal window
qualia --token <API_KEY> model types

Or set the QUALIA_API_KEY environment variable:

Terminal window
export QUALIA_API_KEY="your-api-key"

Quick Start

Section titled “Quick Start”
Terminal window
# Check authentication
qualia auth status


# List available VLA model types
qualia model types


# List available GPU instances
qualia instance list


# Create a project
qualia project create "My Robot Project"


# Get dataset image keys for camera mapping
qualia dataset get-image-keys lerobot/pusht


# Launch a fine-tuning job
qualia job launch \
  --project-id <PROJECT_ID> \
  --vla-type smolvla \
  --model-id lerobot/smolvla_base \
  --dataset-id lerobot/pusht \
  --dataset-last-modified "2025-01-15T10:00:00Z" \
  --model-last-modified "2025-01-15T10:00:00Z" \
  --hours 2.0 \
  --camera-mappings '{"cam_1": "observation.images.top"}'


# Check job status
qualia job get <JOB_ID>


# Cancel a job
qualia job cancel <JOB_ID>

Output Formats

Section titled “Output Formats”

All commands that display data support a --json flag for machine-readable output:

Terminal window
qualia model types --json
qualia job get <JOB_ID> --json

Without --json, output is displayed as formatted tables using Rich.

Configuration

Section titled “Configuration”
SourceDescription
--token flagAPI key (highest priority)
--base-url flagOverride API base URL
QUALIA_API_KEY env varAPI key
QUALIA_BASE_URL env varOverride API base URL
Config file (see above)Persistent config from qualia auth login

Priority: --token/--base-url flags > environment variables > config file.

Requirements

Section titled “Requirements”
  • Python 3.10+
  • qualia-sdk >= 0.1.6

Next Steps

Section titled “Next Steps”