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