transformerlab-cli 0.0.67

Transformer Lab CLI

Transformer Lab CLI

Install

uv tool install transformerlab-cli

Usage

 Usage: lab [OPTIONS] COMMAND [ARGS]...

 Transformer Lab CLI

╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --format        TEXT  Output format: pretty or json [default: pretty]        │
│ --help                Show this message and exit.                            │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ version              Display the CLI version.                                │
│ config               View or set configuration values.                       │
│ status               Check the status of the server.                         │
│ login                Log in to Transformer Lab.                              │
│ logout               Log out from Transformer Lab.                           │
│ whoami               Show the current logged-in user and team.               │
│ task                 Task management commands.                               │
│ job                  Job management commands.                                │
│ notes                Experiment notes commands.                              │
│ provider             Compute provider management commands.                   │
│ server               Server installation and configuration commands.         │
│ dataset              Dataset management commands.                            │
│ model                Model management commands.                              │
│ experiment           Experiment management commands.                         │
│ install-agent-skill  Install the AI agent skill for `lab`.                   │
╰──────────────────────────────────────────────────────────────────────────────╯

Command Reference

For a full list of all commands with detailed options and example usage, see COMMANDS.md.

Claude Code Skill

Want Claude Code (or other AI coding agents) to manage Transformer Lab for you? Install the skill:

lab install-agent-skill

This is a thin wrapper around the underlying installer:

npx skills add transformerlab/transformerlab-app --skill transformerlab-cli

This teaches your AI agent how to use the lab CLI to check job status, stream logs, download artifacts, queue tasks, manage providers, and more. See .agents/skills/transformerlab-cli/ for the full skill definition.

Development

Run (DEV)

uv run src/transformerlab_cli/main.py

Build Locally

Option A — Global install (simple)

uv tool install . --force --reinstall

This installs lab into ~/.local/bin/ so it's available from any shell.

Option B — Editable install into an active venv (recommended for iterative dev)

# Activate the venv you want lab installed into, e.g.
source ~/.transformerlab/envs/general-uv/bin/activate

# From the cli/ directory:
uv pip install -e .

lab will live at <venv>/bin/lab and only resolve while that venv is active. Code changes take effect without reinstalling.

⚠️ Gotcha: if a cli/.venv directory exists, uv pip install targets it instead of your active $VIRTUAL_ENV, and which lab will come up empty. Either delete it (rm -rf cli/.venv) or force the target explicitly: uv pip install -e . --python "$VIRTUAL_ENV/bin/python".

Debug the Job Monitor

Install editable into your active venv (see Option B above), then:

uv run textual run --dev src/transformerlab_cli/commands/job_monitor/job_monitor.py

and then in another window:

textual console -x SYSTEM -x EVENT -x INFO

Run Textual in Browser

uv run textual serve src/transformerlab_cli/commands/job_monitor/job_monitor.py