Skip to content

Getting Started

m4bwav edited this page Nov 15, 2026 · 1 revision

Getting started

Install

In Claude Code:

/plugin marketplace add m4bwav/labwright
/plugin install labwright@labwright

Write the registry

labwright reads your hosts from a registry file, hosts.json, kept in a private folder outside the repository.

  1. Make a folder for it and set LABWRIGHT_HOME to that folder.
  2. Copy skills/labwright/hosts.example.json into it as hosts.json.
  3. Fill in each host: name, os, local (true when this machine can read the host's GPU and disks), gpu (name, vram_gb) or unified_gb for shared memory, ram_gb, speed (relative; faster hosts are tried first), roles (image, video, music, llm, train), services (comfyui, ollama or http with a URL) and stores (model folders).

Top-level keys: floor_gb is the free space a download must leave (default 100) and idle.gpu_busy_pct is the GPU load at which a host counts as busy (default 15). The full format is in registry.md.

A remote store whose disk cannot be read can carry free_gb with a free_checked date.

Check it

python skills/labwright/scripts/lw.py doctor

doctor probes every host and lists drift between the registry and what the servers report, such as a GPU name or VRAM size that no longer matches. To use a registry somewhere else, pass --hosts FILE before the command:

python skills/labwright/scripts/lw.py --hosts ./hosts.json status

Clone this wiki locally