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,56 @@
+# GPU Fan — START TUTAJ
+
+**Cel:** Wiedzieć od czego zacząć i czy ta aplikacja idzie do Dockera.  
+**Czas:** 2 minuty czytania  
+**Wymagania:** Brak (to tylko mapa dokumentacji)
+
+---
+
+## Jednozdaniowa odpowiedź
+
+**GPU Fan NIE działa w Dockerze — instalujesz go na hoście (systemd), raz, i zapominasz.**
+
+Steruje wentylatorami karty graficznej. Reszta (ComfyUI, LocalAI) może być w Dockerze — to osobne programy.
+
+---
+
+## Mapa dokumentacji
+
+| Plik | Kiedy czytać |
+|------|----------------|
+| [01-INSTALACJA-KROK-PO-KROKU.md](01-INSTALACJA-KROK-PO-KROKU.md) | Pierwsza instalacja na serwerze |
+| [02-OTWIERANIE-UI-W-PRZEGLADARCE.md](02-OTWIERANIE-UI-W-PRZEGLADARCE.md) | Chcesz otworzyć panel w przeglądarce |
+| [03-KRZYWa-I-TRYBY.md](03-KRZYWa-I-TRYBY.md) | Chcesz zmienić chłodzenie / tryb wentylatorów |
+| [04-CZESTE-BLEDY.md](04-CZESTE-BLEDY.md) | Coś nie działa |
+| [05-DLACZEGO-NIE-DOCKER.md](05-DLACZEGO-NIE-DOCKER.md) | „A czemu nie w kontenerze?” |
+
+Dla agentów AI / deweloperów: [../coding-agent/DOCKER-VS-HOST-REPORT.md](../coding-agent/DOCKER-VS-HOST-REPORT.md)
+
+---
+
+## Szybka ścieżka (jeśli się spieszysz)
+
+```bash
+cd ~/cursor/ubuntu-bare-metal/stacks/gpu-fan
+nvidia-smi                    # musi pokazać kartę — jeśli nie, najpierw napraw driver
+sudo scripts/install.sh
+sudo scripts/enable-lan.sh
+sudo systemctl start gpu-fan
+sudo systemctl status gpu-fan
+```
+
+Potem: [02-OTWIERANIE-UI-W-PRZEGLADARCE.md](02-OTWIERANIE-UI-W-PRZEGLADARCE.md)
+
+---
+
+## Co zobaczysz gdy działa
+
+- `systemctl status gpu-fan` → **active (running)**
+- W przeglądarce: panel z temperaturą GPU i wykresem krzywej (port **8090**)
+- Wentylatory reagują na temperaturę (w trybie **curve**)
+
+---
+
+## Co zrobić gdy nie działa
+
+→ [04-CZESTE-BLEDY.md](04-CZESTE-BLEDY.md)