Skip to content
Qualia Docs

Overview

The official command-line interface for the Qualia robotics data and VLA platform. Built on the Python SDK.

Installation

Section titled “Installation”
Terminal window
pip install qualia-cli

Authentication

Section titled “Authentication”

Create an API key in Settings in the Qualia dashboard, then run:

Terminal window
qualia auth login

You’ll be prompted for your API key, which is saved to a platform-specific config directory:

  • Linux: ~/.config/qualia/config.toml
  • macOS: ~/Library/Application Support/qualia/config.toml
  • Windows: %APPDATA%\qualia\config.toml

Alternatively, pass the token directly (useful in CI/scripts):

Terminal window
qualia --token <API_KEY> credit

Or set the QUALIA_API_KEY environment variable:

Terminal window
export QUALIA_API_KEY="your-api-key"

Quick Start

Section titled “Quick Start”
Terminal window
# Check authentication
qualia auth status


# Inspect adapter-pinned camera descriptors for a dataset version
qualia dataset training-features <DATASET_VERSION_UUID>


# Materialize its verified LeRobot v3 closure
qualia dataset materialize <DATASET_VERSION_UUID> ./training-set-v7

Output Formats

Section titled “Output Formats”

All commands that display data support a --json flag for machine-readable output:

Terminal window
qualia credit --json
qualia dataset training-features <DATASET_VERSION_UUID> --json

Without --json, output is displayed as formatted tables using Rich.

Configuration

Section titled “Configuration”
SourceDescription
--token flagAPI key (highest priority)
--base-url flagOverride API base URL
QUALIA_API_KEY env varAPI key
QUALIA_BASE_URL env varOverride API base URL
Config file (see above)Persistent config from qualia auth login

Priority: --token/--base-url flags > environment variables > config file.

Requirements

Section titled “Requirements”
  • Python 3.10+
  • qualia-sdk >= 0.1.6

Next Steps

Section titled “Next Steps”