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 import-hf`

Preflight and import one exact Hugging Face dataset commit on the CLI client. The command prints the exact file count, byte count, and tree digest before an interactive confirmation, then uses QDS’s staged direct-to-storage publisher. Success creates a Source and a pinned immutable DatasetVersion with a paired Git audit identity.

export HF_TOKEN="..." # optional for public datasets
qualia dataset import-hf \
  qualia-robotics/openarm-cube-in-box-v1 \
  17c29c487d886878ddcb3c5649101b2860fbc047 \
  openarm-cube-in-box \
  --source-format lerobot_v3

The revision must be lowercase 40-hex; branches, tags, URLs, and embedded credentials are rejected. HF_TOKEN is read only from the environment (or the Hub’s protected local credential store) and is never accepted as a command-line option. Use --max-bytes, --max-files, and --work-dir to tighten local resource bounds. Repositories with zero-byte files fail preflight because QDS cannot publish them without changing the source tree. --json requires --yes so stdout remains valid JSON.

The summary separately reports root .gitattributes/.gitignore metadata. Those two exact Git-control names are downloaded, content-verified, and bound in the audit sidecar before exclusion from the QDS payload; arbitrary hidden files are rejected.

`qualia dataset curation-suggest`

Explain bad-data recommendations for immutable DatasetVersions without mutating them. Use --page-token to continue the digest-bound result set.

qualia dataset curation-suggest <DATASET_VERSION_UUID>
qualia dataset curation-suggest <DATASET_VERSION_UUID> --json

`qualia dataset curate`

Publish the reviewed analysis’s sealed recommendation set as a new immutable DatasetVersion. Supply a stable idempotency UUID. Source bytes and Git history are not deleted.

qualia dataset curate <DATASET_VERSION_UUID> \
  --definition-id <DATASET_DEFINITION_UUID> \
  --idempotency-key <OPERATION_UUID> \
  --yes

Omit --yes for an interactive confirmation.

`qualia dataset materialize`

Render and download one immutable DatasetVersion as a verified LeRobot v3 directory. Transfer bytes go directly from object storage; the CLI validates the paged artifact closure and atomically publishes a new destination.

qualia dataset materialize <DATASET_VERSION_UUID> ./training-set-v7
qualia dataset materialize <DATASET_VERSION_UUID> ./training-set-v7 --json

Argument	Description
`DATASET_VERSION_ID`	Immutable dataset-version UUID (required)
`DEST`	New destination directory; must not already exist

`qualia dataset training-features`

Show the adapter-pinned camera, stream, timebase, and frame-timestamp descriptors for one immutable DatasetVersion.

qualia dataset training-features <DATASET_VERSION_UUID>
qualia dataset training-features <DATASET_VERSION_UUID> --json

Argument	Description
`DATASET_VERSION_ID`	Immutable dataset-version UUID (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-version-id <DATASET_VERSION_UUID> \
  --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`, `pi05`, `act`, or `sarm`
`--dataset-version-id`	UUID	Yes	Immutable QDS DatasetVersion
`--hours`	float	Yes	Training duration (max 168)
`--camera-mappings`	JSON	Yes	Camera slot to image key mapping
`--model-id`	str	No	Hugging Face model ID (required for `smolvla` and `pi05`)
`--model-revision`	SHA	No	Exact commit SHA; required when `--model-id` is not built-in
`--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