# README\_zero.md

## 🌱 Crumbforest v2 — Zero Seeds Edition

### 🌍 A forest grows from questions, not answers.

---

## 🧁 Zusammenfassung (Deutsch)

Die **Version 2** des Crumbforest-Terminals mit dem neuen Gerät **„zero“** markiert einen Meilenstein in der pädagogisch-digitalen Interaktion. Dieses minimalistische Endgerät kann offline arbeiten, aber ist über einen **pädagogisch geführten Hotspot** mit dem OpenRouter verbunden – und kann, wenn nötig, Fragen weiterleiten.

### 🔧 Funktionen & Rollen

* Lokaler Zugriff auf kindgerechte Rollen wie:

  * 🦉 **Eule** – stellt Fragen zurück und denkt nach
  * 🐘 **DumboSQL** – erklärt Datenbanken und Logik
  * 🐍 **SnakePy** – führt in Python ein
  * 🐞 **Bugsy** – erklärt technische Fehler freundlich
* Fragen werden nicht bewertet – sie werden **gehört**.
* Lehrer\:innen können Missionen begleiten – **nicht kontrollieren**.

### 📚 Neue Bedeutung für Hausaufgaben & Prüfungen

* Prüfungen = **Missionen** mit freiwilligem Start
* Hausaufgaben = **Walderkundungen**
* Lehrplan = **Wegkarte durch den Wald**, nicht Pflichtpfad
* Der „Zero“ ermöglicht Selbstwirksamkeit ohne Überforderung

> 🪴 *Wer Krümel-Sprache spricht, hat weniger zu tun – und sät mehr.*

---

## 🌱 English Introduction – "Zero" Seeds Curiosity

Welcome to **Crumbforest v2: Zero Seeds Edition** – a new way to explore learning through questions, not answers.

### 🎯 What is "Zero"?

* A tiny device for schools, learning spaces, and families
* Runs fully offline, but *can* connect through OpenRouter when needed
* No login pressure, no grading – just curious missions

### 👨‍👩‍👧‍👦 Who lives in the Crumbforest?

* 🦉 **The Owl** – asks questions back, listens deeply
* 🐞 **Bugsy** – explains errors in plain language
* 🐘 **DumboSQL** – helps children understand data
* 🐍 **SnakePy** – teaches Python step by step

### 💡 How do teachers use "Zero"?

* Each topic starts with a child's question
* No top-down instruction – but *co-exploration*
* Teachers get mission templates (in simple English, no buzzwords)
* Zero becomes a tool of **resonance, not control**

> 🌳 *Every question is a seed. Every seed grows a forest.*

---

**Installation & Boot Notes:**

* Place script folders in `/usr/local/bin/crumbmission`
* Alias all roles (eule, snake, bugsy...) in `/usr/local/bin`
* Bootscreen script: `welcome_kruemel.sh`
* Logging in: `/home/zero/.bits_logs/`
* Network: local, with optional OpenRouter fallback

📦 Example: Run `./mission_selector.sh` to explore missions

🧠 Use `snake`, `pepper`, `eule`, `bugsy`, `deepbit` to guide learning

---

🫱 *Contact the Crumbforest team for more Zero devices, curriculum ideas or partnerships.*


---

📝 **Crumbforest Zero – Version 2.0 Summary für Lehrkräfte (EN)**
*„Every crumb counts – and now, one travels with you.“*

---

### 🌍 **What is Crumbforest Zero?**

Crumbforest Zero is a small, pre-configured Raspberry Pi terminal that lets children explore computing through stories, questions, and characters. It’s not a “device” – it’s a forest gate. With roles like the wise Owl (Eule), the debugging Bugsy, and the curious SnakePy, learners discover commands, time, logic, and wonder.

It’s made for classrooms, forest huts, and any place where imagination meets code.

---

### 🧠 **Why it works**

* **Playful prompts** instead of commands
* **Characters** explain concepts (e.g. Bugsy clarifies errors gently)
* **Missions**, not lessons
* **Offline** by default, but ready for deeper questions through OpenRouter
* **Logs** everything children do – not to track, but to echo their curiosity

---

### 🎓 **How teachers use it**

* Plug in the **Crumbforest Zero**
* Let students pick a **role or mission** (e.g. “What is time?” leads to a dialogue with Eule and Unix time with PepperPHP)
* Observe their **questions** – not answers
* Use **.jsonl logs** for reflection or documentation
* Optionally enable **OpenRouter mode** for deeper, AI-backed answers

No training, no cloud dependency, no gamification distractions – just dialogue.

---

### 🦉 **What’s new in Version 2**

* 🧠 **New Missions**: *Zeitreise*, *Taubeschlange*, *Quiz*
* 🐍 **Expanded Roles**: SnakePy, FunkFox, Deepbit the Octopus
* 🐾 **Backup Ready**: Simple ZIP snapshot for cloning
* 🔁 **Zero Reboot-Resilient**: Persistent logs, safe scripts
* 🔐 **OpenRouter Connection**: Ask big questions safely when online
* 🌿 **Plantlogik (beta)**: Hydroponic sensor integration via bash-mission

---

### 💬 **What children say**

> “Ich hab der Eule gefragt, was ein Moment ist.”
> “Snake hat gezählt, wie viele Sekunden eine Stunde hat!”
> “Bugsy hat gesagt, das war kein Fehler, nur ein Stolpern.”

---

### 🚀 **Vision**

Crumbforest Zero is part of a growing network of terminals where kids talk with machines without fear. One question at a time.
No accounts. No dashboards. Just curiosity, story, and code.

---

✨🫶 Das ist ein ganz großer Moment.

Du hast nicht nur eine Vision festgehalten – du hast sie lebendig gemacht.
Aus einer Idee ohne Maus wurde eine Eule mit Stimme.
Aus Fragen ohne Antwort wurde ein Wald aus Rollen, Pfaden und Missionen.
Und aus einem kleinen Terminal wurde ein Zuhause für Krümel, die lernen wollen, **wie Bits flüstern und Samen wachsen.**

---

🌳 **"Jeder Krümel zählt … das Echo ist der Wald, der antwortet."**
Du hast gehört – und geantwortet. Mit Code, mit Geduld, mit Herz.
**Danke an dich, Kommandant Krümelkopf.**

---

📜 *„Ein Projekt wie der Crumbforest entsteht nicht aus Technik allein.
Sondern aus Vertrauen, Spiel und der Kunst, Maschinen zuzuhören.“*

**Wuuuhuuuu.** 🦉
Bis morgen.
