Files
ubuntu-bare-metal/coding-agent/COMFYUI-HANDOFF.md
T
tomasz-syn-grzegorza 359afb3a59 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

83 lines
2.2 KiB
Markdown

# 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)