diff --git a/README.md b/README.md index f3a05d6..ffc66e9 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ # 🌲 Crumbforest Missions - CF_Zero_V1 -Ein interaktives Bash-Lern-System mit KI-gestützten Charakteren für spielerisches Command-Line-Training. +Ein interaktives Bash-Lern-System mit 15 KI-gestützten Waldwächtern für spielerisches Command-Line-Training und Roboter-Projekte. + +**"Was kostet die Frage eines Kindes?"** - Transparentes Token-Tracking für pädagogische Zwecke. ## 🚀 Quick Start @@ -10,42 +12,255 @@ Ein interaktives Bash-Lern-System mit KI-gestützten Charakteren für spielerisc # Einzelne Mission ausführen bash missions/basics/fridolin.sh + +# Robots Mission (neu!) +bash missions/robots/mond_maschine.sh ``` +## 🤖 Robots-Kategorie ⭐ NEU! + +Drei komplette Missionen zum Roboter-Bauen mit der ganzen Crew: + +### 🔋 LiPo Power Academy +"Power braucht Respekt, nicht Angst" +- 8 Phasen: Grundlagen → Sicherheit → Power-Verteilung +- Lerne alles über LiPo-Batterien für Roboter-Projekte +- 6 Waldwächter: CapaciTobi, CrabbyRust, Schnecki, Schraubbär, DumboSQL, Vektor +- [LiPo 6S Charger Simulator](https://194-164-194-191.sslip.io/crumbblocks/lipo_6s_charger_sim_safe_v7.html) + +### 🌈 Regenbogen-Zählmaschine +"Etwas bauen was noch keiner gebaut hat - sonst muss man es ja nur reparieren!" +- 7 Phasen: Vision → Hardware → Code → Art +- Baue einen Farb-Event-Counter mit Sensor, Code & Visualisierung +- 13 Waldwächter: Die komplette Crew! +- Hardware + Software + Creative Coding + +### 🌙 Mond Maschine - Rainbow Predictor +"Vorhersagen heißt verstehen - Die Natur durch Code begreifen" +- 8 Phasen: Computer Vision → ML → Astronomie +- Predict when rainbows appear using moon phases & weather data +- 13 Waldwächter: Computer Vision, APIs, ML Light +- OpenCV + Weather APIs + Astronomical calculations +- Bonus: Learn about Lunar Rainbows! 🌙🌈 + ## 📚 Features -- **Interaktive Lernmissionen** - Von Navigation bis DNS -- **KI-Assistenten** - Charakterbasierte Helfer (Deepbit, Bugsy, Schnippsi, etc.) +- **Interaktive Lernmissionen** - Von Basics bis Advanced & Robots +- **15 Waldwächter** - KI-Assistenten mit Persönlichkeit (siehe unten) +- **Das Dreieck** - DumboSQL, FunkFox, Taichi Taube (Foundation) - **Metadata-driven** - Neue Missionen ohne Code-Änderungen hinzufügen -- **Kamera-Gestenerkennung** - SnakeCam mit Computer Vision -- **Token-Tracking** - OpenRouter API Nutzung überwachen +- **Token-Tracking** - Transparent: "Was kostet die Frage eines Kindes?" +- **Crew Memory** - Waldwächter kommunizieren miteinander +- **Logs im Repo** - Strukturiert in `logs/{character}/` + +## 🌲 Die 15 Waldwächter + +### 🔺 Das Dreieck (Foundation) +- **🐘 DumboSQL** - Der nie vergessende Elefant (SQL & Daten) +- **🦊 FunkFox** - Der Bash Rapper (Terminal-Flow mit Beat) +- **🕊️ Taichi Taube** - Die Balance-Bringerin (Spirale & Ordnung) + +### 🔧 Hardware-Team +- **🐿️ CapaciTobi** - Kondensator-Experte (Elektronik & Power) +- **🐌 Schnecki** - Verkabelungs-Guru (langsam & präzise) +- **🐻 Schraubbär** - Mechanik-Meister (schweres Gerät) + +### 💻 Code-Team +- **🐍 SnakePy** - Python-Guide (mehrere Wege zeigen) +- **🧓 PepperPHP** - Structure Mentor (MVC wie ein Rezept) +- **🦀 CrabbyRust** - Security Guardian (Memory-safe) +- **🕷️ Spider** - Network Feeler (APIs & Verbindungen) + +### 🎨 UI-Team +- **✂️ Schnippsi** - CSS & Styling (alles schick machen) +- **📄 Templatus** - Template-Master (HTML-Struktur) +- **👾 ASCII-Monster** - Terminal Artist (ASCII-Art) + +### 🧭 System-Team +- **🦉 Maya-Eule** - Weise Eule mit Gedächtnis (Meta-Wissen) +- **🔧 Deepbit** - Bash-Erklärer (deep diving) +- **🐛 Bugsy** - Debugging-Helfer (Fehler-Detektiv) +- **🧭 Vektor** - Point-to-Point Guide (Navigation) ## 🦊 Verfügbare Missionen -### Basics +### 📚 Basics - **Fridolin** - Navigation (`pwd`, `ls`, `cd`) - **Balu** - Dateien erstellen (`mkdir`, `touch`, `echo`) - **Noko** - Dateien lesen (`cat`, `head`, `tail`, `grep`) -### Advanced +### 🚀 Advanced - **DNS Deep Dive** - DNS-Tools (`dig`, `nslookup`, `host`) - **SSH Security** - SSH-Verbindungen und Keys -## 🤖 KI-Assistenten +### 🏆 Challenges +- **Stage Builder** - Komplexe Bash-Herausforderungen + +### 🤖 Robots ⭐ NEU! +- **🔋 LiPo Power Academy** - Batterie-Wissen für Roboter +- **🌈 Regenbogen-Zählmaschine** - Farb-Event-Counter +- **🌙 Mond Maschine** - Rainbow Predictor mit Computer Vision + +## 🤖 Waldwächter nutzen ```bash -export OPENROUTER_API_KEY="your-key" -./crumbforest_roles/deepbit_zero.sh "Wie funktioniert grep?" +# Source die Library +source lib/waldwaechter.sh + +# Frag einen Waldwächter +mayaeule "Was ist wichtiger - das Ziel oder der Weg?" +funkfox "Erkläre mir Pipes im Flow!" +dumbosql "Wie strukturiere ich eine Datenbank?" +snakepy "Zeig mir 3 Wege, um eine Liste zu sortieren" + +# Alle verfügbar: +# mayaeule, deepbit, bugsy, schnippsi, templatus +# tobi, schraubaer, schnecki +# dumbosql, funkfox, taichitaube +# snakepy, pepperphp, crabbyrust +# spider, vektor, asciimonster ``` +## 📊 Token-Tracking & Logs + +**Philosophie:** "Was kostet die Frage eines Kindes?" + +- Token-Verbrauch wird transparent angezeigt +- Logs landen in `logs/{character}/` +- Crew Memory: Waldwächter lesen andere Logs +- Mission Logs: `logs/missions/*.json` + +```bash +# Logs checken +ls logs/ +ls logs/mayaeule/ +cat logs/missions/mond_maschine_*.json +``` + +Typische Kosten: +- Einzelne Frage: ~200-800 tokens (~$0.0002-0.0008) +- Komplette Mission: ~5,000-7,000 tokens (~$0.005-0.007) +- **Unter 1 Cent pro Mission!** 💚 + ## 📖 Dokumentation -Siehe [CLAUDE.md](CLAUDE.md) für vollständige Architektur und Entwickler-Dokumentation. +- **[CLAUDE.md](CLAUDE.md)** - Vollständige Architektur & Entwickler-Docs +- **[KEKSHANDBUCH_ZERO_v0.0.md](KEKSHANDBUCH_ZERO_v0.0.md)** - User Manual mit allen 15 Waldwächtern -## 🌍 Philosophie +## 🌍 Philosophien -**Waldwächter-Prinzip:** Transparenz über Magie - Metadata-driven, erweiterbar, bildungsfreundlich. +**"Das Dreieck"** - DumboSQL, FunkFox, Taichi Taube +- Struktur, Flow & Balance +- Die Grundlage für komplexe Projekte + +**"Power braucht Respekt, nicht Angst"** - LiPo Power Academy +- Sicherheit durch Wissen +- 7 goldene Regeln für LiPo-Batterien + +**"Etwas bauen was noch keiner gebaut hat"** - Regenbogen-Zählmaschine +- Kreativität statt Reparatur +- Inspiriert durch Kinderfragen + +**"Vorhersagen heißt verstehen"** - Mond Maschine +- Die Natur durch Code begreifen +- Computer Vision + Machine Learning + Astronomie + +**"Was kostet die Frage eines Kindes?"** +- Token-Tracking für Transparenz +- Pädagogischer Wert über alles + +**"Ein Elefant vergisst nie"** - DumboSQL +- Crew Memory über Projekt-Grenzen +- Persistente Konversations-Historie + +**"wir ja nie fertig"** 🌱 +- Der Wald wächst mit jeder Idee +- Community-driven Education + +## 🏗️ Projekt-Struktur + +``` +CF_Zero_V1/ +├── crumb-mission-selector.sh # Hauptmenü +├── lib/ +│ └── waldwaechter.sh # 15 Waldwächter als Functions +├── crumbforest_roles/ # 17 Character Scripts +├── missions/ +│ ├── basics/ # Einsteiger +│ ├── advanced/ # Fortgeschrittene +│ ├── challenges/ # Herausforderungen +│ └── robots/ # 🤖 NEU! 3 Robot-Missionen +├── logs/ # 🌲 Projekt-basierte Logs +│ ├── {character}/ # Pro Waldwächter +│ └── missions/ # Mission Logs +├── CLAUDE.md # Projekt-Dokumentation +├── KEKSHANDBUCH_ZERO_v0.0.md # User Manual +└── README.md # Diese Datei +``` + +## 🔧 Setup + +```bash +# .env erstellen mit API Key +echo "OPENROUTER_API_KEY=your-key-here" > .env + +# Mission Selector starten +./crumb-mission-selector.sh + +# Oder direkt eine Mission +bash missions/robots/mond_maschine.sh +``` + +## 🎯 Use Cases + +- **Terminal lernen** - Interaktive Bash-Basics +- **Roboter bauen** - Hardware + Software Projekte +- **Computer Vision** - OpenCV mit SnakePy lernen +- **Datenbanken** - SQL mit DumboSQL verstehen +- **APIs integrieren** - Spider zeigt den Weg +- **Kreativ coden** - Projekte die Spaß machen! + +## 🌟 Besonderheiten + +- **Alle Waldwächter haben Persönlichkeit** - FunkFox rappt, Maya-Eule philosophiert +- **Inter-Character Communication** - Waldwächter lesen andere Logs +- **Metadata-driven** - Missions als .sh + .meta.json +- **Token-Transparenz** - Kosten werden angezeigt +- **Community-driven** - Missionen entstehen aus User-Ideen +- **Raspberry Pi kompatibel** - Läuft auf Raspi Zero! + +## 📦 Requirements + +- Bash 3.2+ (macOS default) +- curl, jq +- OpenRouter API Key +- Optional: Python 3 für Robot-Missionen (opencv-python, numpy, ephem) + +## 🚀 Next Steps + +1. Mission Selector starten: `./crumb-mission-selector.sh` +2. Eine Robot-Mission ausprobieren +3. Eigene Mission-Idee einreichen +4. Den Wald wachsen lassen! 🌱 + +## 🔗 Links + +- [LiPo 6S Charger Simulator](https://194-164-194-191.sslip.io/crumbblocks/lipo_6s_charger_sim_safe_v7.html) +- [Rainbow Counter Demo](https://194-164-194-191.sslip.io/crumbblocks/rainbow_counter.html) + +--- + +## 🏷️ Version + +**v0.1-robots-complete** +- 3 Robot-Missionen +- 15 Waldwächter komplett +- Logs im Repo +- Token-Tracking +- Crew Memory --- *Erstellt mit 💚 im Crumbforest* + +**"Der Wald ist nie fertig - er wächst mit jeder Idee!"** 🌲🌱