Initial version of gui for our T-SQL AI framework.

docs/troubleshooting.md

@@ -0,0 +1,23 @@
+# Troubleshooting
+
+## "Model-Liste konnte nicht geladen werden"
+- Prüfe Ollama:
+  - `curl -s http://127.0.0.1:11434/api/tags | head`
+- Prüfe Port-Bind:
+  - `ss -ltnp | grep 11434`
+
+## GUI startet, aber kein Fenster unter Hyprland
+- Starte mit:
+  ```bash
+  QT_QPA_PLATFORM=wayland python sql_ai_gui.py
+  ```
+- Alternativ testweise XWayland:
+  ```bash
+  QT_QPA_PLATFORM=xcb python sql_ai_gui.py
+  ```
+
+## Runtime Update Button fehlgeschlagen
+- Stelle sicher, dass Docker verfügbar ist:
+  - `docker ps`
+- Rechte:
+  - Dein User sollte in der `docker` Gruppe sein (oder nutze sudo-basierten Wrapper).