# Research: Stability Matrix na gmktec-k11

Data: 2026-07-04  
Host: `gmktec-k11` — Ubuntu 26.04 minimized, RTX 3090 Ti 24 GB, **tylko SSH (headless)**

## Czym jest Stability Matrix

[LykosAI/StabilityMatrix](https://github.com/LykosAI/StabilityMatrix) to menedżer pakietów + **GUI desktop** (Avalonia/.NET) do instalacji ekosystemu Stable Diffusion:

- Pakiety: ComfyUI, Forge/A1111, Fooocus, InvokeAI, Kohya, StableSwarmUI, …
- Funkcje: Inference UI, Model Browser (CivitAI/HF), wspólny katalog modeli
- Linux: oficjalnie **AppImage** (`StabilityMatrix-linux-x64.zip`, latest v2.16.1)
- Licencja: AGPL (kod), EULA (binaria)

## Czy działa na Ubuntu?

**Tak — oficjalnie wspierane**, ale jako aplikacja graficzna, nie serwis headless.

| Wymaganie | gmktec-k11 | Ocena |
|-----------|------------|-------|
| OS Linux x64 | Ubuntu 26.04 | OK |
| GPU NVIDIA | RTX 3090 Ti, `nvidia-smi` | OK |
| FUSE (AppImage) | Ubuntu minimized — brak domyślnie | Dołożyć `libfuse2t64` |
| GUI (X11/Wayland) | Serwer SSH, minimized | **Brak** — SM wymaga pulpitu |
| Miejsce na dysku | `/data` ~1 TB | OK |
| Konflikt GPU | LocalAI na 8070 | Jeden duży workload GPU naraz |

### Znane problemy (GitHub Issues)

- Ubuntu 24.04+: `libfuse2t64` wymagane do AppImage
- Instalacja pakietów: czasem brakuje `build-essential`, `python3-dev`, … ([#1454](https://github.com/LykosAI/StabilityMatrix/issues/1454))
- Headless: możliwe z VNC/X11, ale SM nie jest do tego zaprojektowany
- PATH w subprocessach: sporadyczne błędy `nvidia-smi` ([#1577](https://github.com/LykosAI/StabilityMatrix/issues/1577))

## Werdykt

| Pytanie | Odpowiedź |
|---------|-----------|
| Czy można zainstalować na Ubuntu? | **Tak** (AppImage + zależności) |
| Czy ma sens na **tym** hoście? | **Nie** — tylko SSH, bez GUI |
| Zgodność z repo `ubuntu-bare-metal`? | **Słaba** — tutorial 03b zakłada ComfyUI **w Dockerze** |

## Decyzja

**Stability Matrix nie instalujemy.**

Zamiast SM wdrażamy stack **ComfyUI w Dockerze** (`stacks/comfyui/`) — odpowiednik funkcji (generowanie obrazów / ComfyUI), bez GUI-menedżera, zgodny z architekturą repo.

## Gdyby kiedyś (z GUI)

Tylko z VNC/RDP + lightweight desktop lub fizycznym monitorem:

```bash
sudo apt install libfuse2t64
cd /data/apps
wget https://github.com/LykosAI/StabilityMatrix/releases/download/v2.16.1/StabilityMatrix-linux-x64.zip
unzip StabilityMatrix-linux-x64.zip
chmod +x StabilityMatrix.AppImage
./StabilityMatrix.AppImage   # wymaga DISPLAY
```

Data Directory: `/data/apps/stability-matrix/` — osobna ścieżka, niezależna od Docker stacks.

## Powiązane

- [`stacks/comfyui/README.md`](../stacks/comfyui/README.md)
- [`COMFYUI-DEPLOYMENT.md`](COMFYUI-DEPLOYMENT.md)
- [`COMFYUI-HANDOFF.md`](COMFYUI-HANDOFF.md)
- [`SWARMUI-REMOVAL.md`](SWARMUI-REMOVAL.md) — poprzedni UI obrazów usunięty