# 01 — ComfyUI Setup

ComfyUI is installed at `~/ComfyUI/` on the Arising Media workstation.
Python venv is at `~/ComfyUI/venv/`.

## Starting ComfyUI

```bash
tmux new-session -d -s comfyui \
  "cd ~/ComfyUI && HSA_OVERRIDE_GFX_VERSION=10.3.0 venv/bin/python main.py --listen 0.0.0.0 --port 8188 2>&1 | tee ~/comfyui.log"
```

**Do NOT use `--cpu`.** The GPU is an AMD Ryzen 9 9950X integrated graphics
(gfx1036, RDNA 2 iGPU) with 30,942 MB unified VRAM (shares system RAM).
All models fit: FLUX (12GB), Wan 2.2 (3.2GB), T5-XXL (4.6GB).

`HSA_OVERRIDE_GFX_VERSION=10.3.0` is required — gfx1036 (iGPU) is not in
the PyTorch ROCm kernel list, but gfx1030 (RDNA 2 dGPU) is compatible.
Without the override: `HIP error: invalid device function` on first compute op.

Previous SOP said 2GB VRAM — that was wrong. It was reading the dedicated
VRAM pool, not the full unified memory PyTorch allocates via ROCm.

Verify it's up:
```bash
curl -s -o /dev/null -w "%{http_code}" http://localhost:8188/system_stats
# should return 200 within 30 seconds
```

Check the log for node load errors:
```bash
tmux attach -t comfyui
```

## Required custom nodes

Both installed at `~/ComfyUI/custom_nodes/`:

- `ComfyUI-GGUF` — loads GGUF quantized models (FLUX, Wan 2.2)
- `ComfyUI-Detail-Daemon` — optional, detail enhancement

If `ComfyUI-GGUF` fails to load, check for missing Python packages:
```bash
~/ComfyUI/venv/bin/pip install gguf sqlalchemy
```

## Known dependency gaps (fix if ComfyUI fails to start)

```bash
~/ComfyUI/venv/bin/pip install sqlalchemy gguf
```

Audio nodes (`nodes_audio.py`, `nodes_lt_audio.py`) will fail to import
because `torchaudio` is not installed. This is safe to ignore — audio
nodes are not used in this pipeline.

## GPU note

GPU: AMD Ryzen 9 9950X integrated graphics (gfx1036, RDNA 2 iGPU)
Unified memory: 30,942 MB available to PyTorch via ROCm (shares system RAM)

```bash
# Verify ROCm sees the GPU
~/ComfyUI/venv/bin/python -c "import torch; print(torch.cuda.is_available()); print(torch.cuda.get_device_name(0))"
# returns True / AMD Ryzen 9 9950X 16-Core Processor

# Verify arch override works
HSA_OVERRIDE_GFX_VERSION=10.3.0 ~/ComfyUI/venv/bin/python -c "
import torch; x=torch.tensor([1.0]).cuda(); print('GPU OK:', x.device)
"
```

gfx1036 requires `HSA_OVERRIDE_GFX_VERSION=10.3.0` — always set this env var
before starting ComfyUI or running any Python that loads GPU tensors.
Without it: `HIP error: invalid device function` immediately on first op.

## Model folder structure

```
~/ComfyUI/models/
├── unet/
│   └── flux1-schnell-Q8_0.gguf          (12GB, FLUX image)
├── clip/
│   ├── clip_l.safetensors               (235MB, FLUX CLIP-L)
│   ├── t5xxl_fp8_e4m3fn.safetensors     (4.6GB, FLUX T5-XXL)
│   └── umt5_xxl_fp8_e4m3fn_scaled.safetensors  (6.3GB, Wan text encoder)
├── vae/
│   ├── ae.safetensors                   (108MB, FLUX VAE)
│   └── wan_2.1_vae.safetensors          (243MB, Wan VAE)
└── diffusion_models/
    └── Wan2.2-TI2V-5B-Q4_K_M.gguf      (3.2GB, Wan 2.2 video)
```

## Stopping ComfyUI

```bash
tmux send-keys -t comfyui C-c
# or kill the session:
tmux kill-session -t comfyui
```