comfyui

# ComfyUI - Stable Diffusion Interface

## Overview

ComfyUI is a powerful node-based Stable Diffusion interface for AI image generation. The `comfyui` command manages the ComfyUI container, including configuration, lifecycle management, model downloads, and custom node management.

**Key Concept:** This is a **system command** - run with `ujust` from anywhere on the system. ComfyUI runs as a Podman Quadlet service. By default, data is ephemeral (stored inside the container). Configure volume mounts for persistent storage.

## Quick Reference

| Action | Command | Description |
|--------|---------|-------------|
| Config | `ujust comfyui config [--models-dir=...] [--output-dir=...] [--port=...]` | Configure ComfyUI |
| Start | `ujust comfyui start` | Start ComfyUI server |
| Stop | `ujust comfyui stop` | Stop ComfyUI server |
| Restart | `ujust comfyui restart` | Restart ComfyUI server |
| Status | `ujust comfyui status` | Show status and model counts |
| Logs | `ujust comfyui logs [--lines=...]` | View service logs |
| Open | `ujust comfyui open` | Open UI in browser |
| Shell | `ujust comfyui shell [-- CMD...]` | Open shell in container |
| Download model | `ujust comfyui download --model-url=<url> --model-type=<type>` | Download from CivitAI |
| List models | `ujust comfyui models` | List installed models |
| Install node | `ujust comfyui node-install --node-url=<url>` | Install custom node |
| List nodes | `ujust comfyui node-list` | List custom nodes |
| Update nodes | `ujust comfyui node-update` | Update all nodes |
| Delete | `ujust comfyui delete` | Remove ComfyUI and images |

## Configuration

### Parameters

| Parameter | Long Flag | Short | Default | Description |
|-----------|-----------|-------|---------|-------------|
| Port | `--port` | `-p` | `8188` | Web UI port |
| GPU Type | `--gpu-type` | `-g` | `auto` | GPU: nvidia/amd/intel/auto |
| Image | `--image` | `-i` | (default image) | Container image |
| Tag | `--tag` | `-t` | `stable` | Image tag |
|