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

docs/installation.md

@@ -0,0 +1,27 @@
+# Installation
+
+## Arch Linux (Pacman)
+```bash
+sudo pacman -S pyside6 python-requests
+```
+
+## venv (optional)
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install PySide6 requests
+```
+
+## Start (Wayland/Hyprland)
+```bash
+python sql_ai_gui.py
+```
+Falls nötig:
+```bash
+QT_QPA_PLATFORM=wayland python sql_ai_gui.py
+```
+
+## Ollama (Docker) Minimal
+```bash
+docker run -d --name ollama   --restart unless-stopped   -p 127.0.0.1:11434:11434   -v /mnt/data/ollama:/root/.ollama   ollama/ollama:latest
+```

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

docs/usage.md

@@ -0,0 +1,22 @@
+# Usage
+
+## Prompt senden
+1. Prompt/Kontext links einfügen
+2. Modell auswählen (Dropdown)
+3. Optional: Streaming aktivieren/deaktivieren
+4. **An AI senden**
+
+## Copy SQL only
+- Extrahiert SQL aus:
+  - ```sql``` code fences
+  - oder „SQL-ähnlichen“ code fences (Keywords wie SELECT/FROM/WHERE ...)
+
+## Modell aktualisieren
+- Button **Modell aktualisieren (pull)** führt `/api/pull` aus.
+- Währenddessen wird der Status unten angezeigt.
+
+## Runtime Update (Ollama)
+- Button **Ollama Runtime updaten** führt aus:
+  - `docker pull ollama/ollama:latest`
+  - `docker restart ollama`
+- Voraussetzung: Docker installiert + Rechte (docker group)