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,82 @@
+# Handoff: ComfyUI stack
+
+Data: 2026-07-04  
+Dla kolejnego agenta / sesji Cursor
+
+## Co zrobiono
+
+1. Research Stability Matrix → decyzja **nie instalować** ([`STABILITYMATRIX-RESEARCH.md`](STABILITYMATRIX-RESEARCH.md))
+2. Utworzono pełny stack [`stacks/comfyui/`](../stacks/comfyui/) — wzorzec `localai`
+3. Dokumentacja wdrożenia i tutorial rozdział 07
+4. Zaktualizowano BACKLOG, Portainer README, politykę GPU LocalAI ↔ ComfyUI
+
+## Co użytkownik musi zrobić na hoście
+
+```bash
+cd ~/cursor/ubuntu-bare-metal/stacks/comfyui
+cp .env.example .env
+./scripts/start.sh
+```
+
+Pierwszy start: kopia ComfyUI do `/data/apps/comfyui/storage/` — kilka minut, duży pull obrazu.
+
+Przed generowaniem obrazów z dużym modelem:
+
+```bash
+cd ../localai && docker compose --profile localai stop localai
+```
+
+## Weryfikacja po wdrożeniu
+
+```bash
+docker ps --filter name=comfyui
+curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8188/
+nvidia-smi
+```
+
+UI: `http://192.168.100.90:8188` (LAN, enp3s0) lub localhost.
+
+## Otwarte / następne kroki
+
+| Priorytet | Zadanie |
+|-----------|---------|
+| P1 | Uruchomić stack na hoście (`./scripts/start.sh`) — **nie wykonane w repo-only** |
+| P2 | Pobrać pierwszy checkpoint SD/SDXL do `models/` |
+| P2 | NPMPlus reverse proxy dla ComfyUI (opcjonalnie, jak LocalAI) |
+| P3 | Bind `127.0.0.1:8188` po proxy (bezpieczeństwo) |
+
+## Polityka GPU (przypomnienie)
+
+RTX 3090 Ti 24 GB — **jeden** duży workload GPU:
+
+- LocalAI (LLM) **lub** ComfyUI (SD/Flux) z modelem w VRAM
+- W Portainer: Stop/Start `localai` / `comfyui`
+
+## Pliki kluczowe
+
+```
+stacks/comfyui/
+├── docker-compose.yml      # profile comfyui, port 8188, gpus: all
+├── .env.example
+└── scripts/start.sh        # ostrzeżenie gdy localai running
+
+coding-agent/
+├── STABILITYMATRIX-RESEARCH.md
+├── COMFYUI-DEPLOYMENT.md
+└── COMFYUI-HANDOFF.md      # ten plik
+
+manual-tutorial/07-comfyui-stack.md
+```
+
+## Czego nie robić bez prośby
+
+- `git commit` / `git push`
+- Pobieranie modeli SD przy `docker compose pull`
+- Instalacja Stability Matrix AppImage
+- Edycja `.cursor/plans/`
+
+## Powiązane
+
+- [`BACKLOG.md`](BACKLOG.md)
+- [`STATE.md`](STATE.md) — zaktualizuj po uruchomieniu na hoście
+- [`SWARMUI-REMOVAL.md`](SWARMUI-REMOVAL.md)