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> credit
qualia --base-url http://localhost:8004 auth status

`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 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)