Frank
02883d3ed2
Copy of the legacy ~/.pi/agent/docs tree rebuilt as the command-center knowledge base: concept files promoted to path identity, index listings stripped of frontmatter, all wikilinks/relative links resolved, every checkable claim verified against the live fleet (Dankserver = Ryzen 7 7700X + RTX 3090; Strix Halo is Dankclaw), unverifiable claims tagged. kb-lint exits 0.
88 lines
2.6 KiB
Markdown
88 lines
2.6 KiB
Markdown
# 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
|