Metadata-Version: 2.4
Name: transformerlab-cli
Version: 0.0.12
Summary: Transformer Lab CLI
Author-email: Transformer Lab <hello@transformerlab.ai>
License: Apache-2.0
Project-URL: Homepage, https://lab.cloud/for-teams/cli
Project-URL: Repository, https://github.com/transformerlab/transformerlab-app
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Environment :: Console
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.9.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: rich>=13.0.0
Requires-Dist: textual>=0.86.0
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: sentry-sdk>=2.54.0

# Transformer Lab CLI

![Main Screenshot](https://raw.githubusercontent.com/transformerlab/transformerlab-app/main/cli/screenshots/screenshot001.png)

![Job Monitor Screenshot](https://raw.githubusercontent.com/transformerlab/transformerlab-app/main/cli/screenshots/screenshot002.png)

## Install

```bash
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.                                      │
│ task      Task management commands                                           │
│ job       Job management commands                                            │
╰──────────────────────────────────────────────────────────────────────────────╯
```

## Command Reference

For a full list of all commands with detailed options and example usage, see [COMMANDS.md](https://github.com/transformerlab/transformerlab-app/blob/main/cli/COMMANDS.md).

## Claude Code Skill

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

```bash
npx skills add transformerlab/transformerlab-app
```

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/](https://github.com/transformerlab/transformerlab-app/tree/main/.agents/skills/transformerlab-cli) for the full skill definition.

## Development

### Run (DEV)

```bash
uv run src/transformerlab_cli/main.py
```

### Build Locally

```bash
uv tool install .
```

or rebuild with:

```bash
uv tool install . --force --reinstall
```

Adds a `lab` command to your terminal.

### Debug the Job Monitor

```bash
pip install -e .
uv run textual run --dev src/transformerlab_cli/commands/job_monitor/job_monitor.py
```

and then in another window:

```bash
textual console -x SYSTEM -x EVENT -x INFO
```

### Run Textual in Browser

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