🌲 CrumbCodex v0.0 - Genesis

12 Monate Crumbforest-Wachstum, sortiert nach Waldlogik.

Struktur:
- 454 Dokumente in 7 organischen Ebenen
- Lichtung → Waldrand → Waldmitte → Wurzeln → Krone → Unterholz → Samen
- INDEX.md für jede Ebene (eigene Stimme)
- WALDKARTE.md (Master-Navigation)
- crumbcodex.md (Das Versprechen zwischen Krümel & Bits)
- lichtung/willkommen.md (Nullfeld-Einstieg für Kinder)

Philosophie:
- Waldlogik statt Ordnerlogik
- Tiefe, Licht, Wurzeln - wie ein echter Wald
- Schutz für Krümel, Tiefe für Gräber, Poesie für Atmende

Repos verbunden:
- OZM-Keks-Handbuch-v1 (Das Wissen)
- Crumb-Core-v.1 (Das Herz) - 194.164.194.191
- crumbmissions (Das Spiel)

Wuuuhuuuuu! 🦉
This commit is contained in:
2025-12-26 16:50:52 +01:00
commit 83df9de035
487 changed files with 39758 additions and 0 deletions

159
waldmitte/docker/CrumbOS.md Normal file
View File

@@ -0,0 +1,159 @@
# 🍰 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.51.5 Watt**
- SD-Karte mit 1632 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.51.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? 😌