# ComfyUI

Node-based AI image generation engine running on `dankclaw`. Serves a web UI on port 8188.

## Access

Open `http://dankclaw:8188` in a browser. Accessible from any host on the 192.168.0.0/24 LAN.

## Architecture

| Property | Value |
|----------|-------|
| **Host** | dankclaw (192.168.0.143) |
| **Version** | v0.30.0 |
| **Python** | 3.14.4, venv at `~/ComfyUI/venv` |
| **PyTorch** | 2.13.0+cu130 (CPU backend) |
| **Backend** | CPU — ROCm unavailable on Strix Halo (GFX13) |
| **Model** | FLUX.2 [klein] 4B (7.3 GB, Apache 2.0) |
| **Service** | User-level systemd, `~/.config/systemd/user/comfyui.service` |
| **Models dir** | `~/models` via `extra_model_paths.yaml` |

## Directory Layout

```
/home/dank/
├── ComfyUI/
│   ├── main.py              # Entry point
│   ├── venv/                # Python virtual environment
│   ├── extra_model_paths.yaml  # Links ~/models as model source
│   └── models/              # ComfyUI-native model subdirs (empty)
└── models/
    └── checkpoints/
        └── flux-2-klein-4b.safetensors
```

## Service Management

```bash
# Check status
ssh dank@dankclaw 'systemctl --user status comfyui --no-pager'

# Restart
ssh dank@dankclaw 'systemctl --user restart comfyui'

# Stop
ssh dank@dankclaw 'systemctl --user stop comfyui'

# View logs
ssh dank@dankclaw 'journalctl --user -u comfyui --no-pager -n 50'
```

## Add a New Model

Place the `.safetensors` file in `~/models/checkpoints/`. ComfyUI detects it on restart.

```bash
# Example: download a new model
ssh dank@dankclaw 'mkdir -p ~/models/checkpoints'
scp new-model.safetensors dank@dankclaw:~/models/checkpoints/
ssh dank@dankclaw 'systemctl --user restart comfyui'
```

## Performance

The AMD Ryzen AI MAX+ 395 has 16 CPU cores. ROCm does not support the Strix Halo (GFX13) APU in precompiled wheels. ComfyUI runs on CPU only. Expect generation times in the range of minutes per image.

## ComfyUI-Manager

Custom node manager installed at `~/ComfyUI/custom_nodes/ComfyUI-Manager`. Provides a UI to browse, install, and update custom nodes and models directly from the ComfyUI web interface.

### Install a Custom Node

1. Open the ComfyUI web UI
2. Click **Manager** in the sidebar
3. Search for the node and click **Install**
4. Restart ComfyUI when prompted

### Update All Nodes

```bash
ssh dank@dankclaw 'cd ~/ComfyUI && source venv/bin/activate && python custom_nodes/ComfyUI-Manager/cm-cli.sh update' && systemctl --user restart comfyui
```

## See Also

- [Troubleshooting](troubleshooting.md) — Common errors and fixes
- [Dankclaw](../../system/dankclaw.md) — Host system overview