╔══════════════════════════════════════════════════════════════╗
║                    🤖  KI-Werkstatt                          ║
║           Offline-KI für den Grundschulunterricht            ║
╚══════════════════════════════════════════════════════════════╝


WAS IST DAS?
════════════
Die KI-Werkstatt ist ein Chat-Programm mit einer kleinen
Künstlichen Intelligenz, die komplett auf dem eigenen Rechner
läuft – ohne Internet, ohne Cloud, ohne Anmeldung.

Kinder können Fragen stellen und die KI antwortet in
einfacher, kinderfreundlicher Sprache.


WAS BRAUCHE ICH?
═════════════════
• Windows 10 oder 11
• Mindestens 8 GB Arbeitsspeicher (RAM)
• Ca. 4 GB freier Speicher (USB-Stick oder Festplatte)
• Einen modernen Browser (Chrome, Edge, Firefox)
• KEINE Internetverbindung nötig!
• KEINE Administrator-Rechte nötig!


ORDNER-STRUKTUR
═══════════════
KI-Werkstatt/
├── start.bat           ← Doppelklick = KI starten
├── stop.bat            ← KI wieder beenden
├── chat.html           ← Die Chat-Oberfläche
├── llama-server.exe    ← Der KI-Server (muss ergänzt werden)
├── *.gguf              ← Die KI-Modelldatei (muss ergänzt werden)
├── setup.py            ← Einmaliges Setup-Skript
├── README.txt          ← Diese Datei
└── assets/             ← Schriften & Bibliotheken (wird von setup.py erstellt)
    ├── katex/
    ├── fonts/
    └── marked.min.js


ERSTEINRICHTUNG (einmalig, mit Internet)
═════════════════════════════════════════

Schritt 1: Web-Assets herunterladen
────────────────────────────────────
Auf einem Rechner MIT Internetzugang:

    python setup.py

Das lädt Schriftarten und Bibliotheken in den assets/-Ordner.
Danach wird kein Internet mehr benötigt.


Schritt 2: KI-Server herunterladen
───────────────────────────────────
a) Gehe zu: https://github.com/ggerganov/llama.cpp/releases
b) Lade die neueste Release-Datei herunter:
   → llama-*-bin-win-cpu-x64.zip
c) Entpacke daraus die Datei "llama-server.exe"
d) Kopiere sie in diesen Ordner (neben start.bat)


Schritt 3: KI-Modell herunterladen
───────────────────────────────────
a) Gehe zu HuggingFace:
   → https://huggingface.co/bartowski/google_gemma-3-4b-it-GGUF
b) Lade herunter: gemma-3-4b-it-Q4_K_M.gguf  (ca. 2.5 GB)
c) Kopiere die .gguf-Datei in diesen Ordner

Alternativ Qwen3:
   → https://huggingface.co/Qwen/Qwen3-4B-GGUF
   → Datei: qwen3-4b-q4_k_m.gguf


Schritt 4: Testen
──────────────────
Doppelklick auf start.bat – der Browser öffnet sich
automatisch mit der KI-Werkstatt.


IM UNTERRICHT BENUTZEN
══════════════════════

1. USB-Stick einstecken
2. start.bat doppelklicken
3. Warten bis „Server läuft!" erscheint
4. Im Browser tippen und die KI antwortet
5. Am Ende: stop.bat oder Fenster schließen


TIPPS
═════
• Die KI braucht 5–15 Sekunden pro Antwort – das ist normal!
• Der Regler „Kreativität" bestimmt, wie fantasievoll
  die Antworten sind (links = sachlich, rechts = kreativ).
• „Gedächtnis" bestimmt, wie viel sich die KI vom
  bisherigen Gespräch merkt.
• Bei Problemen: stop.bat ausführen und start.bat neu starten.


FEHLERBEHEBUNG
══════════════

Problem: „Der KI-Server antwortet nicht"
→ Ist das Kommandozeilen-Fenster noch offen?
→ stop.bat ausführen, dann start.bat erneut starten.

Problem: SmartScreen-Warnung bei llama-server.exe
→ „Weitere Informationen" klicken → „Trotzdem ausführen"
→ Falls blockiert: IT-Abteilung muss die .exe freigeben.

Problem: Sehr langsame Antworten
→ Andere Programme schließen (spart Arbeitsspeicher)
→ Kleineres Gedächtnis-Fenster wählen (500 oder 1000)

Problem: Browser zeigt Fehler bei Schriften/Formeln
→ setup.py wurde nicht ausgeführt → einmalig nachholen.


TECHNISCHE DETAILS
══════════════════
• Server: llama.cpp (C++, portable, keine Installation)
• API: OpenAI-kompatibel auf http://127.0.0.1:8080
• Frontend: HTML/CSS/JS (Einzeldatei, alle Assets lokal)
• Modell: 4B Parameter, Q4_K_M Quantisierung
• RAM-Bedarf: ca. 2.5 GB für das Modell + System
• Inferenz: CPU-only (kein GPU nötig)
