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