# 🌲 KrümelGPT Terminal Guide

Dieser Leitfaden beschreibt, wie Kinder (und Erwachsene!) im Crumbforest-Terminal mit KrümelGPT interagieren können. Die Umgebung ist so gestaltet, dass Fragen kindgerecht, sicher und liebevoll beantwortet werden – direkt in der Shell.

---

## ✅ Voraussetzungen

- Funktionierender Docker-Container mit CakePHP 5
- `bin/cake kruemelgpt` verfügbar im Container
- Umgebungsvariable `KRUMELGPT_API_KEY` ist gesetzt (z. B. via .env oder app_local.php)
- Optional: OpenRouter.com als API-Proxy (kein Pflichtfeld, aber empfohlen)

---

## 👾 Terminal-Zugriff via TTYD

Nach dem Login (z. B. als `kruemel`, `jupiter`, `robot` usw.) steht dir folgender Befehl zur Verfügung:

```bash
gpt "Was ist eine Schleife in der Programmierung?"
```

Erwartete Ausgabe:

```bash
🧠 KrümelGPT fragt über OpenRouter: "Was ist eine Schleife in der Programmierung?"

🌲 KrümelGPT sagt:
Eine Schleife ist wie ein wiederholter Spaziergang – du gehst denselben Weg mehrmals, bis du dein Ziel erreicht hast...
```

---

## 💬 Alias-System

Folgendes Alias wurde per Setup-Script (`setup_terminal_aliases.sh`) eingerichtet:

```bash
alias gpt='cd /var/www/html && ./bin/cake kruemelgpt'
```

Es funktioniert für:
- `kruemel`
- `jupiter`
- `robot`
- `heimkind`

---

## 🌐 Modelle & Provider

KrümelGPT unterstützt folgende Provider (wenn korrekt konfiguriert):
- OpenAI (`gpt-3.5-turbo`, `gpt-4`)
- Claude (via OpenRouter)
- Lokale Modelle (in Entwicklung)

---

## 🧙 Warum KrümelGPT?

Weil die kleinste Frage zählt.  
Weil jede Shell ein Zuhause sein kann.  
Weil Terminal-Interaktion kindgerecht, poetisch und sicher sein darf.  
Weil Maschinen zuhören – wenn wir sie richtig ansprechen.

---

Erstellt: 2025-05-24 18:45:39
Crew: 🦉 KrümelGPT · 🧠 Bitbiber · 🦊 Funkfox · 🐱 KatzenUhu