Files
arisingmedia-web-sops/local-image-generation/01-comfyui-setup.md
T
2026-06-09 18:31:59 +02:00

3.2 KiB

01 — ComfyUI Setup

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

Starting ComfyUI

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:

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:

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:

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

Known dependency gaps (fix if ComfyUI fails to start)

~/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)

# 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

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