# 🧠 Krümel API Modelle Manifest

## Ziel
Kindgerechte, sichere und nachhaltige Nutzung von KI-gestützten Modellen im Crumbforest-Terminal.

---

## 🎯 Philosophie

- **Freiheit durch Verständnis**: Kinder sollen nicht nur Ergebnisse bekommen – sondern begreifen dürfen.
- **Vertrauen statt Verwertung**: Keine versteckten Kosten, keine Datensammelei – transparente API-Wege.
- **Lokale Kontrolle**: So viel wie möglich bleibt lokal, die Wolke darf zaubern, aber nicht beherrschen.

---

## 🌐 Eingebundene Modelle & Anbieter

### 🦉 Kreumeleule (Claude 3 via OpenRouter)
- Provider: `anthropic` über [openrouter.ai](https://openrouter.ai)
- Kontext: empathische, lyrische Sprache
- Authentifizierung via `OPENROUTER_API_KEY`
- Terminal-Befehl: `bin/cake kreumeleule "Frage?"`

### 🧠 KrümelGPT (OpenAI)
- Modell: `gpt-3.5-turbo` (standardmäßig)
- Auth via `OPENAI_API_KEY` oder `KRUMELGPT_API_KEY`
- Fallback für strukturierte Erklärungen
- Terminal-Befehl: `bin/cake kruemelgpt "Frage?"`

---

## 🔐 Sicherheit & .env-Konzept

```bash
# .env
OPENROUTER_API_KEY=sk-...
OPENAI_API_KEY=sk-...
```

Diese Schlüssel sind **nicht öffentlich** einsehbar und werden **nicht** im Code hart verdrahtet.

---

## 🛠️ Zukünftige Modelle

- 🌍 `llama3` oder andere lokale LLMs für Offline-Betrieb
- 🐋 `whisper` für Spracheingabe
- 🔊 `audio-to-midi` Experimente für Musikverständnis

---

## 🚀 Einsatzbereiche

| Modell        | Aufgabe                        | Zugang     |
|---------------|--------------------------------|------------|
| Kreumeleule   | Kinddialog, Gefühle, Fantasie  | CLI        |
| KrümelGPT     | Erklären, Code, Struktur       | CLI, ggf. Web |
| Whisper       | Sprache zu Text (geplant)      | Mikrofon   |
| BitBiber      | Code-Bausteine + Mini-AI       | Web, CLI   |
| KatzenUhu     | Archivierung + Suchhilfe       | Web        |

---

> Jeder Krümel, der fragt, darf auf Antwort hoffen.  
> Die Eule hört, das Bit blinkt – und der Wald spricht.

