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,69 @@
+# 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