Qualia CLI

Terminal interface for the Qualia robotics data and VLA platform.

Install

pip install qualia-cli

Or with uv:

uv tool install qualia-cli

Pre-release builds

Deployments running ahead of the public release need the matching pre-release wheel — the upload protocol is negotiated exactly, so the CLI and the endpoint it talks to have to be the same generation. Pin it:

pip install 'qualia-cli==0.2.0rc1'

uv does not resolve a pre-release through a dependency, even one that names it, so uv needs the flag as well as the pin:

uv tool install --prerelease=allow 'qualia-cli==0.2.0rc1'

Quick start

# Authenticate (pick one)
qualia auth login                        # interactive, saves to config
export QUALIA_API_KEY="your-api-key"     # env var
qualia --token <KEY> <command>           # inline, for CI/scripts

# List available models
qualia model list

# List GPU instances
qualia instance list

# Create a project
qualia project create "My Robot"

# Start a fine-tuning job
qualia job launch \
  --project-id <id> \
  --vla-type smolvla \
  --model-id lerobot/smolvla_base \
  --dataset-version-id <DATASET_VERSION_UUID> \
  --hours 2.0 \
  --camera-mappings '{"cam_1": "observation.images.top"}'

# Check job status
qualia job get <job-id>

# Import an exact Hugging Face dataset commit. HF_TOKEN is read from the
# environment or the Hub's protected local credential store, never an argv flag.
export HF_TOKEN="..."  # omit for public datasets
qualia dataset import-hf \
  qualia-robotics/openarm-cube-in-box-v1 \
  17c29c487d886878ddcb3c5649101b2860fbc047 \
  openarm-cube-in-box \
  --source-format lerobot_v3

JSON output

All commands support --json for machine-readable output:

qualia project list --json
qualia credit --json