101 lines
3.2 KiB
Markdown
101 lines
3.2 KiB
Markdown
# 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
|
|
```
|