Commands

Global Options

These flags can be used with any command:

| Option | Description | | ------------ | ------------------------------------------------ | | --token | API key (overrides config file and env var) | | --base-url | API base URL (overrides config file and env var) |

qualia --token <API_KEY> project list
qualia --base-url http://localhost:8004 model types

`qualia version`

Show CLI and SDK versions.

qualia version

`qualia auth`

`qualia auth login`

Save your API key for future use. Prompts for the key interactively.

qualia auth login

| Option | Description | | ------------ | ----------------------------- | | --api-key | API key (prompted if omitted) | | --base-url | Override API base URL |

`qualia auth status`

Check current authentication configuration.

qualia auth status

`qualia credit`

Show your current credit balance.

qualia credit
qualia credit --json

`qualia project`

`qualia project list`

List all projects.

qualia project list
qualia project list --json

`qualia project create`

Create a new project.

qualia project create "My Project"
qualia project create "My Project" -d "Optional description"

| Argument / Option | Description | | --------------------- | ----------------------- | | NAME | Project name (required) | | -d, --description | Optional description |

`qualia project delete`

Delete a project. Fails if the project has active jobs.

qualia project delete <PROJECT_ID>

`qualia model`

`qualia model types`

List available VLA model types.

qualia model types
qualia model types --json

`qualia instance`

`qualia instance list`

List available GPU instance types and pricing.

qualia instance list
qualia instance list --json

`qualia dataset`

`qualia dataset get-image-keys`

Get available image keys from a HuggingFace dataset for camera mapping.

qualia dataset get-image-keys lerobot/pusht
qualia dataset get-image-keys lerobot/pusht --json

| Argument | Description | | ------------ | --------------------------------- | | DATASET_ID | HuggingFace dataset ID (required) |

`qualia job`

`qualia job list`

List jobs across all projects, or filter by project.

qualia job list
qualia job list --project-id <PROJECT_ID>
qualia job list --json

`qualia job launch`

Launch a new 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"}'

| Option | Type | Required | Description | | ------------------------- | ----- | -------- | ------------------------------------------------------------ | | --project-id | str | Yes | Project ID | | --vla-type | str | Yes | Model type: smolvla, pi0, pi05, act, gr00t_n1_5 | | --dataset-id | str | Yes | HuggingFace dataset ID | | --dataset-last-modified | str | Yes | Dataset last-modified timestamp | | --model-last-modified | str | Yes | Model last-modified timestamp | | --hours | float | Yes | Training duration (max 168) | | --camera-mappings | JSON | Yes | Camera slot to image key mapping | | --model-id | str | No | HuggingFace model ID (required for smolvla, pi0, pi05) | | --instance-type | str | No | GPU instance type (default: auto-selected) | | --region | str | No | Cloud region | | --batch-size | int | No | Training batch size (default: 32) | | --name | str | No | Job name | | --hyper-spec | JSON | No | Custom hyperparameters as JSON |

`qualia job get`

Get detailed job status, including phase progression.

qualia job get <JOB_ID>
qualia job get <JOB_ID> --json

`qualia job cancel`

Cancel a running job.

qualia job cancel <JOB_ID>

`qualia job hyperparams`

Show default hyperparameters for a VLA model type.

qualia job hyperparams smolvla
qualia job hyperparams smolvla --model-id lerobot/smolvla_base

| Argument / Option | Description | | ----------------- | ----------------------------------- | | VLA_TYPE | VLA model type (required) | | --model-id | Model ID for type-specific defaults |