Initial import: bare-metal stacks, Server UI, GPU fan, tutorials.

Infrastructure configs for GMKtec K11 (Docker, vLLM, LocalAI, ComfyUI, control-plane, gpu-fan agent, Server UI with CLI/file explorer/GPU fan curve). Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-05 12:02:04 +00:00
commit 359afb3a59
153 changed files with 18169 additions and 0 deletions
@@ -0,0 +1,119 @@
+# Wdrożenie ComfyUI stack (Docker)
+
+Data: 2026-07-04  
+Host: `gmktec-k11` — RTX 3090 Ti 24 GB, `/data` zamontowany
+
+## Kontekst
+
+Po researchu [Stability Matrix](STABILITYMATRIX-RESEARCH.md) — **nie instalujemy SM** (wymaga GUI). Zamiast tego ComfyUI w Dockerze, wzorowany na `stacks/localai/`.
+
+SwarmUI usunięte 2026-07-04 — [`SWARMUI-REMOVAL.md`](SWARMUI-REMOVAL.md).
+
+## Podsumowanie stacku
+
+| Element | Wartość |
+|---------|---------|
+| Stack | [`stacks/comfyui/`](../stacks/comfyui/) |
+| Kontener | `comfyui` |
+| Obraz | `yanwk/comfyui-boot:cu126-slim` |
+| Port | **8188** |
+| Profil compose | `comfyui` |
+| Dane | `/data/apps/comfyui/` |
+
+## Architektura
+
+```mermaid
+flowchart TB
+    subgraph host [gmktec-k11 headless]
+        localai[localai :8070]
+        comfyui[comfyui :8188]
+        dockge[server-ui :8091]
+    end
+    data["/data/apps/comfyui/"]
+    comfyui --> data
+    note["GPU: localai LUB comfyui — nie oba z dużym modelem"]
+```
+
+## Pliki w repo
+
+| Plik | Rola |
+|------|------|
+| `stacks/comfyui/docker-compose.yml` | GPU, port 8188, bind mounty |
+| `stacks/comfyui/.env.example` | `DATA_ROOT`, `COMFYUI_PORT`, obraz |
+| `stacks/comfyui/scripts/start.sh` | ensure-dirs, pull, up, ostrzeżenie o LocalAI |
+| `stacks/comfyui/scripts/ensure-dirs.sh` | katalogi na `/data` |
+| `stacks/comfyui/scripts/pull.sh` | tylko `docker compose pull` |
+| `stacks/comfyui/README.md` | dokumentacja stacku |
+
+## Katalogi na hoście
+
+```
+/data/apps/comfyui/
+├── storage/          # kopia ComfyUI (pierwszy start obrazu yanwk)
+├── models/
+├── cache/hf-hub/
+├── cache/torch-hub/
+├── input/
+├── output/
+├── custom_nodes/
+└── workflows/
+```
+
+Istniejące katalogi z `setup-data-disk.sh` (models, input, output, custom_nodes) są rozszerzone przez `ensure-dirs.sh`.
+
+## Procedura wdrożenia
+
+```bash
+cd ~/cursor/ubuntu-bare-metal/stacks/comfyui
+cp .env.example .env
+
+# opcjonalnie: zatrzymaj LocalAI przed dużym modelem SD
+cd ../localai && docker compose --profile localai stop localai
+cd ../comfyui
+
+./scripts/start.sh
+```
+
+Weryfikacja:
+
+```bash
+docker compose --profile comfyui ps
+curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8188/
+nvidia-smi
+```
+
+Oczekiwany HTTP: **200** (po `start_period` healthcheck, ~3 min pierwszy start).
+
+## Polityka GPU
+
+| Scenariusz | Akcja |
+|------------|-------|
+| Chat LLM (LocalAI) | `comfyui` stopped lub bez modelu w VRAM |
+| Generowanie obrazów (ComfyUI) | `localai` stopped |
+| Portainer | Stop/Start kontenerów według potrzeb |
+
+## Modele
+
+- Brak auto-download w `compose pull`
+- Użytkownik: ComfyUI-Manager w UI lub ręcznie do `/data/apps/comfyui/models/`
+- Szacunki VRAM: SDXL ~8–12 GB; Flux ~12–20 GB (mieści się na 24 GB przy zatrzymanym LocalAI)
+
+## Dostęp sieciowy
+
+| Sieć | URL |
+|------|-----|
+| localhost | `http://127.0.0.1:8188` |
+| LAN (po statycznym IP) | `http://192.168.100.90:8188` (enp3s0) |
+| Reverse proxy | opcjonalnie później przez NPMPlus (jak LocalAI) |
+
+## Szacowany rozmiar
+
+- Obraz Docker: ~5–15 GB (zależnie od wariantu yanwk)
+- Modele SD/Flux: dziesiątki GB — użytkownik pobiera sam
+
+## Powiązane dokumenty
+
+- [`COMFYUI-HANDOFF.md`](COMFYUI-HANDOFF.md)
+- [`STABILITYMATRIX-RESEARCH.md`](STABILITYMATRIX-RESEARCH.md)
+- [`manual-tutorial/07-comfyui-stack.md`](../manual-tutorial/07-comfyui-stack.md)
+- [`DOCKER-UI-DEPLOYMENT.md`](DOCKER-UI-DEPLOYMENT.md) — polityka GPU w Portainer