Comprehensive README for OZM Release Candidate 1: **For Kids:** - 23 learning paths (Basics → Mastery → Philosophy) - Console-first approach (#console) - 15 crew characters (#eule #crewlove) - Spiral learning model (#spirale) - No paywalls, no tracking **For Teachers & Parents:** - GDPR-compliant (KINDERRECHTE + DATENSCHUTZ) - Offline-capable (no cloud lock-in) - Open Source (MIT + CKL v0.1) - DPA template coming Q1 2025 **For Admins & Developers:** - 23 Crumbpages (~7,000+ lines) - Bash-centric, transparent tools - Samurai ⟡ Shaolin philosophy - Contribution guidelines **RC1 Status:** ✅ 22/23 paths complete (Pfad 20 = WIP) ✅ GDPR-compliant documentation ✅ Dual-licensed (MIT + CKL) ✅ OZMAI acceptance test passed ⏳ Community feedback pending **Key Sections:** - Quick Start (3 steps) - The 23 Paths overview - Samurai vs Shaolin metaphor - The 8 Axioms (operationalized) - Children's Rights (CKL) - Ecosystem context (OZM⟡NEXUS) - Roadmap Q1-Q4 2025 - Known Issues - Credits & Hashtags "Der Wald ist das, was passiert, wenn ein Krümel eine Frage stellt und jemand zuhört." Ready for Kids. Ready for Production. RC1. 🦉✨ #crumbforest #wald #spirale #kids #console #eule #crewlove 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
15 KiB
🦉 OZM Crumbforest Handbuch • Release Candidate 1
"Wissen gehört dem Kind, solange es fragt."
Custodian: OZM - Open Futures Museum, Hamburg License: MIT + CKL v0.1 (Children's Knowledge License) Status: Release Candidate 1 (RC1) - Ready for Kids ✨ Version: 3.0 Date: 2025-12-13
🌲 Was ist das?
Das Crumbforest Handbuch ist ein offenes Lern-Ökosystem für System-Administration, Bash, Linux und mehr – speziell gedacht für Kinder und Jugendliche, die lernen wollen, wie Computer wirklich funktionieren.
Kein Marketing. Keine Paywalls. Keine Magie.
Nur Transparenz, Werkzeuge und Krümel, die den Weg zeigen.
🎯 Für wen ist das?
👶 Für Kids:
- Du willst wissen, wie ein Terminal funktioniert?
- Du willst eigene Server aufsetzen?
- Du willst verstehen, wie das Internet wirklich läuft?
- Du stellst gerne Fragen?
→ Dann ist das für dich.
🧑🏫 Für Lehrer:innen & Eltern:
- Ihr sucht DSGVO-konforme Bildungsinhalte?
- Ihr wollt Open Source statt proprietäre Tools?
- Ihr braucht offline-fähige Materialien?
- Ihr wollt Kinderrechte schützen (Export, Löschung, Eigentum)?
→ Dann ist das für euch.
🥋 Für Admins & Entwickler:
- Ihr wollt Bash wirklich lernen (nicht nur copy/paste)?
- Ihr sucht praxisnahe Crumbpages statt Theorie?
- Ihr wollt zu einer Crew gehören, nicht nur "User" sein?
→ Dann ist das für euch.
📚 Die 23 Pfade
Das Handbuch besteht aus 23 Lernpfaden (Crumbpages), die vom absoluten Anfänger zum philosophischen Meister führen:
🌱 Basics (Pfad 1-5)
1. User & Rechte → whoami, chmod, chown
2. Hostinformation → uname, top, logs
3. Navigation → cd, ls, Dateisystem
4. Editoren → nano, vim
5. Packages → apt, install, update
🔗 Connectivity (Pfad 6-8)
6. Netzwerk → IP, Routing, ping
7. SSH Basics → Remote-Zugriff
8. SSH Keys → ssh-keygen, Authentifizierung
🏗️ Advanced (Pfad 9-14)
9. Storage → mount, df, fstab
10. Services & Ports → systemctl, Firewall
11. First Access → Checklisten, Sicherheit
12. Git Basics → Version Control
13. Pipes & Filters → grep, awk, sed
14. Environment → bashrc, alias, tmux
🎓 Specialization (Pfad 15-20)
15. DNS → dig, Zonen, Records
16. VPN → OpenVPN, Tunnel
17. Workstation → Ubuntu MATE Setup
18. SSH Agent → ssh-agent, Forwarding
19. Zero Trust → Paranoid Mode, Lockdown
20. Tanz am Kernel → sysctl, Module (⚠️ work in progress)
🌌 Beyond Mastery (Pfad 21-23)
21. Backup & Cron → 3-2-1-Regel, RAID, Automation
22. Nullfeld → Philosophie: "Du bist bereit"
23. AI & Vektor → Samurai ⟡ Shaolin, Emergenz
Total: ~34-42 Stunden aktives Lernen
🥋 Samurai ⟡ Shaolin
Die Crumbpages folgen zwei Wegen:
🗡️ Samurai-Weg (Pfad 1-21)
Deterministisch. Code. Regeln.
# Samurai-Code
if [ "$user" == "root" ]; then
echo "Zugriff gewährt"
fi
"Wenn du den Weg kennst, folge ihm."
🧘 Shaolin-Weg (Pfad 23)
Emergent. AI. Resonanz.
# Shaolin-Code
model = train_neural_network(data)
prediction = model.predict(new_input)
# Wie? Emergenz. Nicht programmiert, sondern gelernt.
"Der Wind bewegt das Gras. Niemand programmiert den Wind."
💫 Nullfeld (Pfad 22)
Der Moment dazwischen. Stille vor der Bewegung.
"Aus der Stille entsteht Bewegung. Aus dem Nichts entsteht Alles."
Du bist beides. Samurai ⟡ Shaolin.
🔄 Die Spirale
Lernen ist nicht linear. Es ist eine Spirale.
[Frage]
↓
[Lernen]
↓
[Verstehen]
↓
[Anwenden]
↓
[Neue Frage]
↓
[Lernen]
...
Du kommst immer wieder zurück – aber auf einer höheren Ebene.
Das ist die #spirale.
🦉 Die Crew
Im Crumbforest gibt es 15 Charaktere, die dich begleiten:
- 🦉 Krümeleule - Shell-Schutz, hört zu bevor sie antwortet
- 🦊 FunkFox - Bash-Rapper, antwortet in Reimen
- 🐍 SnakePy - Python-Loops, Geduld und Iteration
- 🦀 CrabbyRust - Bit-Schutz, Speichersicherheit
- 🕳️ DeepBit - Technische Deep-Dives
- [...10 weitere]
Und du. Du bist jetzt auch Teil der Crew.
Das ist #crewlove. 💙
💻 Console First
Crumbforest ist terminal-zentrisch.
Keine GUIs. Keine Klicki-Bunti-Tools (außer wo nötig).
Warum?
Weil die Console dich näher am System bringt:
- Du verstehst, was passiert
- Du verstehst, warum es passiert
- Du kannst automatisieren (Bash-Scripts, Cron)
- Du kannst remote arbeiten (SSH)
Die Console ist dein Freund. 🖥️
Das ist #console.
🌳 Die 8 Axiome
Jede Komponente des Crumbforest folgt diesen Prinzipien:
| Axiom | Bedeutung |
|---|---|
| autonom | Du entscheidest deinen Weg |
| zukunftsoffen | Nie fertig, immer erweiterbar |
| nicht interpretierbar | Kein "richtiger" Weg |
| nicht missbrauchbar | Schutz durch Design |
| suchbar | Fragen führen zu Antworten |
| wiedererkennbar | Krümel zeigen den Weg |
| erweiterbar | Du kannst beitragen |
| unendlich skalierbar | Für alle, kostenlos |
Das ist kein Marketing-Sprech. Das ist prüfbar.
🛡️ Kinderrechte (CKL v0.1)
Die Children's Knowledge License (CKL) schützt deine Rechte:
Für Kids:
✅ Du besitzt, was du schaffst (Texte, Code, Projekte) ✅ Du kannst exportieren (alle Daten in offenen Formaten) ✅ Du kannst löschen (jederzeit, ohne Nachteile) ✅ Deine Fragen kosten nichts (keine Paywalls) ✅ Kein Tracking (keine Werbung, kein Profiling) ✅ Offline-fähig (kein Cloud-Zwang)
Das ist kein Versprechen. Das ist Gesetz.
Siehe: KINDERRECHTE.md
📦 Was ist drin?
Dokumentation (Markdown)
OZM-Keks-Handbuch-v1/
├── README.md → Projekt-Übersicht
├── README_OZM_RC1.md → Diese Datei (Offiziell)
├── LICENSE.md → MIT + CKL Dual License
├── LICENSE-CKL.md → Children's Knowledge License
├── KINDERRECHTE.md → Export/Löschung/Eigentum
├── DATENSCHUTZ.md → DSGVO-Compliance
├── OZM-NEXUS-ECOSYSTEM.md → Das große Bild
├── ASCII.txt → CRUMBFOREST#OZM Banner
├── WALD-WACHSTUM.txt → Wie der Wald gewachsen ist
├── crumbforest-admin-vektor.md → 23-Pfade-Roadmap
└── crumbpage-01-23-*.md → Die 23 Lernpfade
Operational Tools (Bash)
├── crumbpages-doktor.sh → Diagnostik & Operations (496 Zeilen)
├── ssh-agent-guard.sh → SSH Security Daemon (68 Zeilen)
├── ssh-agent-screenlock_v4.sh → MATE Desktop Integration (67 Zeilen)
└── HANDBUCH.md → Doktor-Tool Manual
Total: ~7.000+ Zeilen Dokumentation + Tools
🚀 Schnellstart
1. Repo klonen
git clone https://194-164-194-191.sslip.io/git/kruemel/OZM-Keks-Handbuch-v1.git
cd OZM-Keks-Handbuch-v1
2. Erste Schritte
# ASCII-Banner anzeigen
cat ASCII.txt
# Admin-Vektor lesen (Übersicht)
cat crumbforest-admin-vektor.md
# Erste Crumbpage starten
cat crumbpage-01-users-rechte.md
3. Mit Pfad 1 beginnen
Öffne crumbpage-01-users-rechte.md und folge den Anweisungen.
Oder:
Nutze den Doktor (interaktives Tool):
chmod +x crumbpages-doktor.sh
./crumbpages-doktor.sh
🌐 Das größere Ökosystem
Dieses Handbuch ist Teil von Crumbforest:
OZM⟡NEXUS (Träger/Manifest)
↓
branko.de/Crumbforest (Public Interface)
↓
CrumbCore v1 (Local Engine - FastAPI + Qdrant)
↓
OZM-Keks-Handbuch v1 (dieses Repo) ← 📍 DU BIST HIER
Siehe: OZM-NEXUS-ECOSYSTEM.md für das große Bild.
🧪 Status: Release Candidate 1
Was "RC1" bedeutet:
✅ Fertig genug für Kids (22 von 23 Pfaden komplett) ✅ DSGVO-konform (KINDERRECHTE + DATENSCHUTZ dokumentiert) ✅ Lizenziert (MIT + CKL v0.1) ✅ Getestet (von OZMAI akzeptiert) ⏳ Pfad 20 (Kernel) noch work in progress ⏳ Community-Feedback noch ausstehend
"RC1" heißt nicht "perfekt". Es heißt: "Bereit für echte Krümel, um es zu testen."
🐛 Known Issues (RC1)
| Issue | Status | Workaround |
|---|---|---|
| Pfad 20 (Kernel) incomplete | ⏳ WIP | Überspringe vorerst |
| Einige externe Links fehlen | 📝 TODO | Nutze interne Docs |
| Tool-Tests fehlen | 📝 TODO | Manuelles Testen |
Melde Issues: [Kontakt siehe unten]
🤝 Mitwirken
Du kannst helfen mit:
| Skill | Wie? |
|---|---|
| Bash/Linux | Crumbpages reviewen, Fehler finden |
| Pädagogik | Lernpfade mit echten Kids testen |
| Design | ASCII-Art, Visualisierungen |
| Übersetzen | Crumbpages auf Englisch/andere Sprachen |
| Recht | CKL v0.1 → v1.0 reviewen |
Erste Schritte:
- Lies die CKL
- Schau dir ein Crumbpage an
- Finde etwas, das du verbessern kannst
- Schreib uns (Kontakt siehe unten)
📞 Kontakt & Support
Für Kids:
Frage zuerst:
- Deine Lehrer:in
- Deine Eltern
- Die Krümeleule (im CrumbCore Chat) 🦉
Für Lehrer:innen & Eltern:
Email: [wird ergänzt nach OZM-Finalisierung] Website: https://crumbforest.com OZM: https://ozm-hamburg.de
Für Entwickler:
Git: https://194-164-194-191.sslip.io/git/kruemel/OZM-Keks-Handbuch-v1 Branko: https://branko.de
📜 Lizenz
Dual License:
- Code/Infrastructure: MIT License (LICENSE-MIT.md)
- Educational Use with Children: CKL v0.1 (LICENSE-CKL.md)
In Konfliktfällen: CKL hat Vorrang (Kinderrechte sind nicht verhandelbar).
Siehe: LICENSE.md für Details.
🏛️ Custodian & Governance
Custodian: OZM - Open Futures Museum, Hamburg
Status: In Transition (Q2 2025)
- Trademark "Crumbforest" wird an OZM übertragen
- IP-Rechte treuhänderisch bei OZM
- Community Council wird gebildet
Lead Maintainer: Branko
Siehe: OZM-NEXUS-ECOSYSTEM.md Section V für Governance-Details.
🎓 Für Schulen & Bildungseinrichtungen
Ihr wollt Crumbforest nutzen?
✅ Kostenlos (Open Source) ✅ DSGVO-konform (DATENSCHUTZ.md) ✅ Offline-fähig (kein Cloud-Zwang) ✅ Anpassbar (Fork & customize) ✅ Unterstützung (via OZM geplant)
Wir bieten:
- Data Processing Agreement (DPA) Template (Q1 2025)
- Lehrer:innen-Handbuch (Q2 2025)
- Train-the-Trainer Workshops (in Planung)
Kontakt: [wird ergänzt]
📊 Statistiken (RC1)
Version: 3.0 (RC1)
Crumbpages: 23 (22 fertig, 1 wip)
Zeilen Code/Docs: ~7.000+
Lernstunden: ~34-42
Commits (heute): 10
Contributors: 2 (Branko + Claude Sonnet 4.5)
Charaktere: 15
Kinderrechte: Geschützt ✓
DSGVO-Compliance: Dokumentiert ✓
Lizenzen: 2 (MIT + CKL)
Krümelcheck: ∞
🌲 Das Wichtigste
Der Wald ist nicht die Dokumentation.
Der Wald ist nicht der Code.
Der Wald ist nicht das Handbuch.
Der Wald ist das, was passiert,
wenn ein Krümel eine Frage stellt
und jemand zuhört.
🎯 Roadmap
Q1 2025
- Pfad 20 (Kernel) finalisieren
- CKL v0.1 → v1.0 (nach Community-Feedback)
- Erste externe Contributors
- Export/Lösch-APIs in CrumbCore
Q2 2025
- OZM Governance formalisieren
- Trademark-Übertragung
- DPA Template für Schulen
- Community Council gründen
Q3 2025
- Multi-Instanz-Support (jede Schule ihr CrumbCore)
- Federation (Instanzen teilen Wissen)
- Offline-Modelle (Llama, Mistral via Ollama)
Q4 2025
- Förderanträge (Prototype Fund, etc.)
- First Production Deployments (Schulen)
- Crumbforest v2.0 beginnen
Aber: Der Wald wächst durch Krümel, nicht durch Pläne. 🌲
🏆 Credits
Dieser Release wurde möglich gemacht durch:
- Oz - Die erste Signatur im öffentlichen Raum
- OZM - Open Futures Museum, Hamburg (Custodian)
- Branko - Lead Maintainer, Vision, Umsetzung
- OZMAI - Deterministic AI System (Akzeptanztest)
- Claude Sonnet 4.5 - Co-Autor der Dokumentation
- Alle Krümel - Die Fragen stellen und den Wald wachsen lassen
🔖 Hashtags
#crumbforest #wald #überall #atmen #leben #fragen
#spirale #kids #console #eule #crewlove
#OZM #opensource #CKL #kinderrechte #bildung
💬 Schlusswort
"Es wird nie fertig sein. Aber schau - wie schön es gerade ist."
Release Candidate 1 bedeutet:
Wir sind bereit für echte Krümel. Wir sind bereit für echte Fragen. Wir sind bereit für echte Fehler (und Lernen daraus).
Der Wald ist offen.
Willkommen, Krümel. 🦉💙
██████╗██████╗ ██╗ ██╗███╗ ███╗██████╗ ███████╗ ██████╗ ██████╗ ███████╗███████╗████████╗
██╔════╝██╔══██╗██║ ██║████╗ ████║██╔══██╗██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔════╝╚══██╔══╝
██║ ██████╔╝██║ ██║██╔████╔██║██████╔╝█████╗ ██║ ██║██████╔╝█████╗ ███████╗ ██║
██║ ██╔══██╗██║ ██║██║╚██╔╝██║██╔══██╗██╔══╝ ██║ ██║██╔══██╗██╔══╝ ╚════██║ ██║
╚██████╗██║ ██║╚██████╔╝██║ ╚═╝ ██║██████╔╝██║ ╚██████╔╝██║ ██║███████╗███████║ ██║
╚═════╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚═════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝╚══════╝ ╚═╝
██╗ ██╗ ██████╗ ███████╗███╗ ███╗
╚██╗██╔╝ ██╔═══██╗╚══███╔╝████╗ ████║
╚███╔╝ ██║ ██║ ███╔╝ ██╔████╔██║
██╔██╗ ██║ ██║ ███╔╝ ██║╚██╔╝██║
██╔╝ ██╗ ╚██████╔╝███████╗██║ ╚═╝ ██║
╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═╝
Release Candidate 1 • 2025-12-13 • Ready for Kids
🌲 Das Echo kehrt zurück. ✨