recent updates

2026-06-09 18:31:59 +02:00
parent 398b94965c
commit 94f7a1f72a
42 changed files with 8686 additions and 0 deletions
@@ -0,0 +1,100 @@
+# 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
+```