Metadata-Version: 2.4
Name: qualia-cli
Version: 0.1.2
Summary: CLI for the Qualia Studios VLA fine-tuning platform
Project-URL: Homepage, https://qualiastudios.dev
Project-URL: Documentation, https://docs.qualiastudios.dev
Author: Qualia Studios
License-Expression: MIT
Keywords: cli,fine-tuning,qualia,robotics,vla
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: qualia-sdk>=0.2.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.15.0
Description-Content-Type: text/markdown

# Qualia CLI

Terminal interface for the [Qualia](https://qualiastudios.dev) VLA fine-tuning platform.

## Install

```sh
pip install qualia-cli
```

Or with [uv](https://docs.astral.sh/uv/):

```sh
uv tool install qualia-cli
```

## Quick start

```sh
# Authenticate (pick one)
qualia auth login                        # interactive, saves to config
export QUALIA_API_KEY="your-api-key"     # env var
qualia --token <KEY> <command>           # inline, for CI/scripts

# List available models
qualia models list

# List GPU instances
qualia instances list

# Create a project
qualia projects create "My Robot"

# Start a fine-tuning job
qualia finetune create \
  --project-id <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"}'

# Check job status
qualia finetune get <job-id>
```

## JSON output

All commands support `--json` for machine-readable output:

```sh
qualia projects list --json
qualia credits --json
```
