System Architecture

Rigs has two layers:

1. Local Skill — dashboard + CLI for managing ComfyUI servers and workflows
2. Network — gateway + marketplace for running jobs on remote GPUs

Local Skill Architecture

ComfyUI Server (GPU)
        ▲  REST + WS
        │
Rigs CLI + Dashboard
        │  config.json + gallery.json
        ▼
Local storage (~/.openclaw/rigs)

• The CLI and dashboard are pure Python + static HTML
• No build step or dependencies
• Workflows are stored as enriched JSON with classified inputs

Network Architecture

Provider GPU         Rigs Gateway          Consumer Browser
┌────────────┐       ┌────────────────┐          ┌───────────────┐
│ ComfyUI    │◄──────│ REST + WS API  │◄────────►│ rigs.run  │
│ Rigs  │ WS    │                │          │ SPA frontend  │
└────────────┘       └────────────────┘          └───────────────┘

Key components:

• Gateway server: Handles REST API, WebSocket connections, job dispatch
• Web SPA: Consumer-facing marketplace at rigs.run
• Stripe integration for deposits + provider payouts
• Cloud storage for outputs and thumbnails
• WebSocket provider connections for real-time job dispatch + progress

Data Flow

1. Consumer submits job → /api/v1/jobs
2. Gateway selects provider and dispatches job via WebSocket
3. Provider runs workflow locally on ComfyUI
4. Gateway streams progress + preview
5. Output stored locally and optionally in R2
6. Consumer downloads via /api/v1/jobs/<id>/output