qualia-cli 0.1.2__tar.gz → 0.2.0rc2__tar.gz

{qualia_cli-0.1.2 → qualia_cli-0.2.0rc2}/.gitignore

@@ -17,6 +17,8 @@ wheels/
 .coverage
 .coverage.*
 htmlcov/
+# Non-secret GitLab job receipts collected by `artifacts:` declarations.
+/artifacts/
 
 # virtual envs
 .venv
@@ -46,7 +48,6 @@ easytier.log
 reset.sql
 
 # generated docs
-ui/docs/src/assets/openapi.json
 
 # nix
 .direnv
@@ -58,7 +59,11 @@ result
 
 # Windows
 nul
-lerobot
+
+# local upstream lerobot checkout (for debugging / vendor comparisons);
+# our ported pipeline_lib_train_lerobot lives at api/pipeline/lib/train/lerobot/
+# and must NOT be ignored.
+/lerobot
 
 # inference setup.sh artifact
 inference/inference/examples/sim/openpi
@@ -89,8 +94,25 @@ dev_access_token.txt
 .ripgreprc
 .zprofile
 .zshrc
+.claude/scheduled_tasks.lock
 /HEAD
 /config
 /hooks
 /objects
-/refs
+/refs
+
+# test data etc
+api/qds/benchmarks/*
+# Bench run artifacts. `benchmarks/` above never covered `bench/results/`, which
+# is where the harness actually writes, so 6k lines of logs rode into a commit.
+api/qds/bench/results/
+api/qds/bench/RESULTS.md
+api/qds/tests/validation/data/
+api/qds/tests/quality_vlm_validation/data/
+api/qds/tests/e2e/fixtures/data/
+
+# Rust build artifacts
+target/
+**/target/
+*.rlib
+*.rmeta

{qualia_cli-0.1.2 → qualia_cli-0.2.0rc2}/PKG-INFO

@@ -1,7 +1,7 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: qualia-cli
-Version: 0.1.2
-Summary: CLI for the Qualia Studios VLA fine-tuning platform
+Version: 0.2.0rc2
+Summary: CLI for the Qualia robotics data and VLA platform
 Project-URL: Homepage, https://qualiastudios.dev
 Project-URL: Documentation, https://docs.qualiastudios.dev
 Author: Qualia Studios
@@ -16,14 +16,15 @@ 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: click>=8.1.0
+Requires-Dist: qualia-sdk>=0.7.0rc2
 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.
+Terminal interface for the [Qualia](https://qualiastudios.dev) robotics data and VLA platform.
 
 ## Install
 
@@ -37,6 +38,23 @@ Or with [uv](https://docs.astral.sh/uv/):
 uv tool install qualia-cli
 ```
 
+### Pre-release builds
+
+Deployments running ahead of the public release need the matching pre-release
+wheel — the upload protocol is negotiated exactly, so the CLI and the endpoint
+it talks to have to be the same generation. Pin it:
+
+```sh
+pip install 'qualia-cli==0.2.0rc1'
+```
+
+uv does not resolve a pre-release through a dependency, even one that names it,
+so uv needs the flag as well as the pin:
+
+```sh
+uv tool install --prerelease=allow 'qualia-cli==0.2.0rc1'
+```
+
 ## Quick start
 
 ```sh
@@ -46,27 +64,34 @@ export QUALIA_API_KEY="your-api-key"     # env var
 qualia --token <KEY> <command>           # inline, for CI/scripts
 
 # List available models
-qualia models list
+qualia model list
 
 # List GPU instances
-qualia instances list
+qualia instance list
 
 # Create a project
-qualia projects create "My Robot"
+qualia project create "My Robot"
 
 # Start a fine-tuning job
-qualia finetune create \
+qualia job launch \
   --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" \
+  --dataset-version-id <DATASET_VERSION_UUID> \
   --hours 2.0 \
   --camera-mappings '{"cam_1": "observation.images.top"}'
 
 # Check job status
-qualia finetune get <job-id>
+qualia job get <job-id>
+
+# Import an exact Hugging Face dataset commit. HF_TOKEN is read from the
+# environment or the Hub's protected local credential store, never an argv flag.
+export HF_TOKEN="..."  # omit for public datasets
+qualia dataset import-hf \
+  qualia-robotics/openarm-cube-in-box-v1 \
+  17c29c487d886878ddcb3c5649101b2860fbc047 \
+  openarm-cube-in-box \
+  --source-format lerobot_v3
 ```
 
 ## JSON output
@@ -74,6 +99,6 @@ qualia finetune get <job-id>
 All commands support `--json` for machine-readable output:
 
 ```sh
-qualia projects list --json
-qualia credits --json
+qualia project list --json
+qualia credit --json
 ```

qualia_cli-0.2.0rc2/README.md

@@ -0,0 +1,80 @@
+# Qualia CLI
+
+Terminal interface for the [Qualia](https://qualiastudios.dev) robotics data and VLA platform.
+
+## Install
+
+```sh
+pip install qualia-cli
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+
+```sh
+uv tool install qualia-cli
+```
+
+### Pre-release builds
+
+Deployments running ahead of the public release need the matching pre-release
+wheel — the upload protocol is negotiated exactly, so the CLI and the endpoint
+it talks to have to be the same generation. Pin it:
+
+```sh
+pip install 'qualia-cli==0.2.0rc1'
+```
+
+uv does not resolve a pre-release through a dependency, even one that names it,
+so uv needs the flag as well as the pin:
+
+```sh
+uv tool install --prerelease=allow 'qualia-cli==0.2.0rc1'
+```
+
+## 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 model list
+
+# List GPU instances
+qualia instance list
+
+# Create a project
+qualia project create "My Robot"
+
+# Start a fine-tuning job
+qualia job launch \
+  --project-id <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"}'
+
+# Check job status
+qualia job get <job-id>
+
+# Import an exact Hugging Face dataset commit. HF_TOKEN is read from the
+# environment or the Hub's protected local credential store, never an argv flag.
+export HF_TOKEN="..."  # omit for public datasets
+qualia dataset import-hf \
+  qualia-robotics/openarm-cube-in-box-v1 \
+  17c29c487d886878ddcb3c5649101b2860fbc047 \
+  openarm-cube-in-box \
+  --source-format lerobot_v3
+```
+
+## JSON output
+
+All commands support `--json` for machine-readable output:
+
+```sh
+qualia project list --json
+qualia credit --json
+```

{qualia_cli-0.1.2 → qualia_cli-0.2.0rc2}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "qualia-cli"
-version = "0.1.2"
-description = "CLI for the Qualia Studios VLA fine-tuning platform"
+version = "0.2.0rc2"
+description = "CLI for the Qualia robotics data and VLA platform"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.10"
@@ -20,7 +20,11 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "qualia-sdk>=0.2.0",
+    "click>=8.1.0",
+    # 0.6.8 moved Hugging Face acquisition behind the server and 0.6.9 is the
+    # first wheel that speaks upload protocol v5. The gateway refuses older
+    # clients at `begin`, before any bytes move.
+    "qualia-sdk>=0.7.0rc2",
     "typer>=0.15.0",
     "rich>=13.0.0",
 ]
@@ -75,6 +79,11 @@ ignore = [
     "E501", # line too long
 ]
 
+[tool.ruff.lint.flake8-bugbear]
+# Typer's Option/Argument defaults are the idiomatic way to declare CLI params;
+# they're effectively immutable sentinels, so don't flag them under B008.
+extend-immutable-calls = ["typer.Option", "typer.Argument"]
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 python_files = ["test_*.py"]

qualia_cli-0.2.0rc2/qualia-cli.spec.md

@@ -0,0 +1,40 @@
+---
+title: Qualia CLI
+category: product
+surface: cli
+capability: launch-finetune
+maturity: review
+verifies:
+  - sdk:contract
+summary: The end-user Typer CLI wrapping the Qualia SDK.
+owners: SDK / DX
+updated: 2026-07-22
+---
+
+## Overview
+
+`qualia` is the end-user command-line interface — a Typer app over the Python SDK, giving the same
+`launch-finetune` capability a terminal surface for scripting and CI. Collocated at `sdk/cli`. Not to
+be confused with `qcore`, the internal developer CLI (see [Engineering →
+qcore CLI is internal tooling]); `qualia` is the public, customer-facing one (QUA-633).
+
+## Surface
+
+The CLI mirrors the SDK's resource model: authenticate via `QUALIA_API_KEY`, then create and manage
+finetunes, list the bounded QDS catalog, download a published tree, inspect adapter-pinned features
+for an immutable `DatasetVersion`, list models/instances, and poll job status. Because it is a thin
+wrapper, its behavior and conformance are inherited from the SDK and the public `/v1` Gateway.
+
+## Conformance
+
+Signal: `sdk:contract` (shared with the SDK). Production certification is pending the full contract
+and deployed-path gates in the QDS execution plan. The active CLI accepts scoped API keys, uses the
+canonical SDK resources, requires an immutable dataset-version UUID for training features and job
+launches, and exposes the distinct `lerobot_v2_1`, `lerobot_v3`, and `mcap_ros2` catalog filters.
+Historical QUA-795 and QUA-796 notes described an older route/auth surface and are not current
+evidence.
+
+## References
+
+- `sdk/cli/`; QUA-633 (end-user CLI shipped)
+- Wraps: [Qualia SDK](/specs/sdk/python/qualia-sdk/) → [Finetune API](/specs/api/gateway/finetune-api/)

qualia_cli-0.2.0rc2/src/qualia_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Qualia CLI for robotics data and VLA workflows."""
+
+__version__ = "0.2.0rc2"

qualia_cli-0.2.0rc2/src/qualia_cli/client.py

@@ -0,0 +1,25 @@
+"""Shared client factory."""
+
+from __future__ import annotations
+
+from qualia import AuthenticationError, Qualia
+
+from qualia_cli.config import load_config
+from qualia_cli.output import print_error
+
+
+def get_client() -> Qualia:
+    from qualia_cli.main import _base_url_override, _token_override
+
+    try:
+        cfg = load_config()
+        api_key = _token_override if _token_override is not None else cfg.api_key
+        base_url = _base_url_override if _base_url_override is not None else cfg.base_url
+        return Qualia(api_key=api_key, base_url=base_url)
+    except (AuthenticationError, OSError, UnicodeError, ValueError) as e:
+        print_error(str(e))
+        print_error(
+            "Set valid QUALIA_API_KEY/QUALIA_BASE_URL values or run: "
+            "qualia auth login --token <KEY>"
+        )
+        raise SystemExit(1) from e

{qualia_cli-0.1.2 → qualia_cli-0.2.0rc2}/src/qualia_cli/commands/auth.py

@@ -4,7 +4,12 @@ from __future__ import annotations
 
 import typer
 
-from qualia_cli.config import load_config, save_config
+from qualia_cli.config import (
+    load_config,
+    save_config,
+    validate_api_key,
+    validate_base_url,
+)
 from qualia_cli.output import print_error
 
 app = typer.Typer(help="Authentication.")
@@ -23,7 +28,7 @@ def login(
     try:
         path = save_config(api_key, base_url)
         typer.echo(f"Config saved to {path}")
-    except OSError as e:
+    except (OSError, ValueError) as e:
         print_error(f"Could not write config: {e}")
         raise SystemExit(1) from e
 
@@ -31,13 +36,15 @@ def login(
 @app.command("status")
 def status() -> None:
     """Check current authentication config."""
-    cfg = load_config()
-    if cfg.api_key:
-        typer.echo(f"API key: {cfg.api_key[:8]}...")
-    else:
-        typer.echo("Not authenticated. Run: qualia auth login")
-        raise SystemExit(1)
-    if cfg.base_url:
-        typer.echo(f"Base URL: {cfg.base_url}")
+    try:
+        cfg = load_config()
+        validate_api_key(cfg.api_key or "")
+        base_url = validate_base_url(cfg.base_url) if cfg.base_url is not None else None
+    except (OSError, UnicodeError, ValueError) as e:
+        typer.echo(f"Invalid authentication config: {e}")
+        raise SystemExit(1) from e
+    typer.echo("API key: configured")
+    if base_url:
+        typer.echo(f"Base URL: {base_url}")
     else:
         typer.echo("Base URL: https://api.qualiastudios.dev (default)")