
# 🍰 CrumbOS für Raspberry Pi Zero 2 W – v1

**Version:** 1.0  
**Datum:** 2025-06-11  
**Ziel:** Autarkes Crumbforest-Kindersystem auf Raspberry Pi Zero 2 W mit Blockly, Vanilla UI, Shell-Rollen und low-power Pädagogik.

---

## 🎯 Zielsetzung

Ein Raspberry Pi Zero 2 W wird als kindgerechte Steuerzentrale eingesetzt:  
- Blockly-Interface für kreative Logik  
- Vanilla-JS UI mit Schnippsi  
- Rollenbasierte Shell-Interaktion (Deepbit, Bugsy, Tobi etc.)  
- Offlinefähig & stromsparend

---

## 🧱 Komponentenübersicht

| Komponente         | Beschreibung                                      |
|--------------------|---------------------------------------------------|
| Raspberry Pi OS    | Lite oder Desktop (32-bit empfohlen)             |
| Webserver          | `lighttpd` oder `nginx`                          |
| Blockly            | Lokal gehostet, einfache Datei- oder API-Bridge  |
| Shell              | `bash` mit kindgerechten `.sh`-Skripten          |
| ttyd/gotty         | Browser-Terminal-Zugang                          |
| Frontend UI        | Vanilla HTML/CSS/JS von Schnippsi                |
| Rollen-Aliase      | `~/.bashrc` oder systemweite Aliase für Kinderrollen |
| OpenRouter (optional) | Für AI-Dialoge wie Bugsy, FunkFox etc. (API-Key nötig) |

---

## 🛠️ Setup-Schritte

### 1. 🥧 Raspberry Pi vorbereiten
- Raspberry Pi OS Lite auf SD-Karte flashen (empfohlen via [Raspberry Pi Imager](https://www.raspberrypi.com/software/))
- WLAN und SSH einrichten (`wpa_supplicant.conf` + leere `ssh`-Datei)

### 2. 📦 Pakete installieren
```bash
sudo apt update && sudo apt install -y \
  nginx bash curl jq git sudo nano figlet toilet \
  nodejs npm
```

### 3. 🌐 Blockly lokal installieren
```bash
git clone https://github.com/google/blockly.git ~/blockly
cd ~/blockly
npm install
npm run build
# Kopiere `blockly` in Webroot (z. B. /var/www/html)
```

### 4. 📂 WebUI & Schnippsi aktivieren
- HTML/CSS/JS in `/var/www/html/` kopieren
- Default-Index auf `index.html` setzen

### 5. 🐚 Rollen-Setup
- `bin/`-Skripte wie `deepbit_hardened_with_api.sh` ausführbar machen
- `alias`-Einträge in `~/.bashrc` ergänzen (z. B. `alias tobi="..."`)
- Logs nach `/tmp/kruemel_logs/` verlinken

### 6. 🧠 (Optional) OpenRouter einbinden
- Um z. B. `bugsy` oder `deepbit` zu aktivieren
- API-Key in Umgebungsvariablen oder Config eintragen

---

## 🌿 Betriebsmodi

- **Standalone-Krümelserver**: Headless oder mit HDMI-Touchscreen  
- **Kiosk-Modus:** Autostart in Chromium (nur bei Desktop-Image)  
- **Remote via SSH:** Steuerung und Update möglich

---

## 🔋 Power & Speicher

- Durchschnittsverbrauch: **0.5–1.5 Watt**
- SD-Karte mit 16–32 GB ausreichend
- Perfekt für Solar/USB-Powerbanks

---

## ❤️ Krümelgedanke

> „Ein Kind mit einem Raspberry Pi ist kein User – es ist ein Schöpfer.“

---

## 🧁 Nächste Schritte (optional)

- crumbos_pi_zero_image_v1.img vorbereiten?
- Autostart mit ttyd und Blockly?
- Paket für Offline-Waldworkshops?

Sag Bescheid 🌲



Oh **jaaaa, absolut! 🧁✨**
Ein 🥧 **Raspberry Pi Zero 2 W** ist wie ein kleiner Krümel mit ganz viel Power für genau **das**, was ihr im Crumbforest gerade zaubert!

---

### ✅ Was kann der Zero 2 W in eurem Setup?

**1. Blockly + Vanilla + Bash (sh/.sh)**
✔️ Blockly läuft lokal per Browser (z. B. `chromium-browser --kiosk`)
✔️ Bash-Skripte? Nativ.
✔️ Vanilla JS + CSS? Perfekt mit leichtem Webserver.
→ **Ergo:** Eure Kinderterminals können autark und stromsparend „tanzen“.

---

### 🧠 Voraussetzungen & Setup-Vorschlag:

| Teil                      | Empfehlung                                              |
| ------------------------- | ------------------------------------------------------- |
| **OS**                    | Raspberry Pi OS Lite (32-bit) oder ein leichtes Debian  |
| **Webserver**             | lighttpd oder nginx *(für Blockly & HTML/CSS/JS)*       |
| **Shell-Logik**           | bash, Python, jq – alles onboard                        |
| **Blockly-Kommunikation** | REST-API oder lokale Datei-Bridge (`curl` oder `node`)  |
| **Editor / UI**           | Chromium im Kiosk-Modus (optional), sonst Terminal-only |
| **TTYD Alternative**      | `ttyd` oder `gotty` läuft auch auf ARM mit Kompilierung |

---

### 🔋 Vorteile des Zero 2 W:

* **Ultra stromsparend** (0.5–1.5 W)
* **Kompakt & leise** → Perfekt für mobile Wald- und Werkstatt-Einsätze 🛠️🌳
* **WiFi & BT integriert**
* Kann als **Shell-Endpunkt**, **Webserver** und sogar als **pädagogische KI-Schnittstelle** via OpenRouter oder lokalem Prompt fungieren

---

### 🔌 Beispielanwendung:

* `blockly-terminal.local` → Kind steuert per Blockly
* Blockly generiert Shell-Logik → `.sh` wird per `eval` oder `bash` ausgeführt
* Deepbit oder FunkFox antworten lokal oder über API (OpenRouter optional)
* Alles läuft auf einem **Mini-Maschinen-Krümelserver** auf dem Raspberry

---

Wenn ihr wollt, kann ich euch ein **Custom-Image-Konzept** für den Zero 2 W schnüren – mit:

* autostartendem Webserver
* ttyd oder lokalem CrumbShell
* schnippsi\_ui als Default-HTML
* Offline Blockly-Knoten
* SSH & Alias-Setup

🌲 **Und der Loop lebt.**
Sag einfach Bescheid: `crumbos_pi_zero_v1.md` incoming? 😌
