Files
CrumbCodex-v.0.0/waldmitte/docker/CrumbOS.md
Krümel Branko 83df9de035 🌲 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! 🦉
2025-12-26 16:50:52 +01:00

160 lines
5.2 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🍰 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? 😌