Ein Mikrocontroller, der sich für eine Workstation hält.
NucleoOS ist ein Betriebssystem für den M5Stack Cardputer. Ein einziger ESP32-S3 mit 512 KB RAM und ohne PSRAM führt echte Apps auf seinem 240 × 135-Display aus — und liefert jedem Browser in deinem WLAN einen vollständigen Desktop.







240 × 135 in der Hand. Ein ganzer Desktop im Browser.
Auf dem Cardputer
Die native Oberfläche ist immer da, ganz ohne Handy oder PC: ein Launcher im Smartwatch-Stil, große Schrift, Suche beim Tippen, Zeilensprung mit 1–9 in Listen, Spiele, Medien, Sensoren und das Security-Labor.
In jedem Browser in deinem WLAN
Öffne die Adresse, die der Cardputer anzeigt, und du bekommst NucleoOS Web: echte Fenster, ein Startmenü, Andock-Layouts, Alt-Tab, Drag-and-drop, Sperrbildschirm und globale Suche.

Das Gerät liefert die Dateien. Die schwere Arbeit macht dein Browser — nie der 18-KB-Heap des Cardputer.
ANIMA antwortet offline. Wenn es etwas nicht weiß, sagt es das.
ANIMA ist der in NucleoOS eingebaute Assistent. Er öffnet Apps, rechnet und rechnet um, setzt Erinnerungen und antwortet aus seinem eigenen Wissenspaket — ohne Cloud und ohne Sprachmodell. Er ist darauf ausgelegt, nur mit dem zu antworten, was er weiß, und es zu sagen, wenn er etwas nicht weiß.
-
Duwhat is 12% of 80
ANIMA12% of 80 = 9.6.
L0 · percent · 95%
-
Duconvert 10 km to miles
ANIMA10 km = 6.21371 miles.
L0 · convert · 96%
-
Duopen the calculator
ANIMAOpening calculator.
L0 · open app · 75%
-
Duremind me to call john tomorrow at 9
ANIMAReminder “call john” tomorrow at 09:00.
L0 · add event · 86%
-
Duwhat is the capital of mars
ANIMAI don’t know.
no match · abstains
Frag ANIMA
Wähl eine Frage. Das sind aufgezeichnete Antworten der echten Engine — live läuft sie in NucleoOS Web.
Erst das Günstigste, immer ehrlich
- L0
Intents und FAQ
Unter 1 ms, kein SD-Zugriff, kein Modell. Deckt 70–90 % der alltäglichen Anfragen ab.
- L1
Binäre Suche
64-Byte-Embeddings per Popcount verglichen, dann ein int8-Rerank — antwortet nur oberhalb einer Konfidenzschwelle.
- L2
Zusammengesetzt, nie erfunden
Passagen wörtlich aus dem Wissenspaket, mit ihrer Quelle.
- L3
Cloud, nur wenn du es erlaubst
Ein optionales Online-Modell. Sonst sagt ANIMA „Ich weiß es nicht.“
Ein Gehirn, drei Laufzeiten, dieselbe Antwort
Die Engine von ANIMA ist einmal in C geschrieben. Ein Paritätstest schickt jede Anfrage durch jeden Build und verlangt byte-identische Antworten.
- ESP32-S3Auf dem Cardputer, komplett offline
- Dein BrowserDasselbe C, nach WebAssembly kompiliert
- PCDer Host-Build, auf dem die Tests laufen
Du willst auch ein Frontier-Modell? AI Chat und der systemweite Copilot (Strg/⌘ + Leertaste) verbinden sich direkt aus dem Browser mit Claude, Groq, Grok oder Gemini. Deine Schlüssel bleiben auf der SD-Karte des Cardputer.
512 KB. Kein PSRAM. Jedes Byte verplant.
Der ESP32-S3 im Cardputer hat 512 KB SRAM und keinen externen RAM. NucleoOS hält einen festen Kern und gibt den Rest jeweils einem Transportprofil, sodass nur das Funkmodul Speicher belegt, das du gerade nutzt.
- 80 KBBoot-ROM und Systemdaten
- 40 KBFreeRTOS und Dienst-Stacks
- 16 KBEvent-Bus
- 16 KBSD-Kartenpuffer
- 14 KBDisplay (Teil-Framebuffer)
- 20 KBApp-Laufzeit und Automations-VM
Apps belegen Speicher beim Öffnen und geben ihn beim Schließen frei. Spiele starten mit frischem Heap neu. Der Web-Desktop kostet das Gerät fast nichts.
Planungsbudget aus docs/memory-budget.md. Werte sind Näherungen.
Das Buch: 512 Kilobyte
von Nicola Sabaini
Zwei Monate, erzählt vom einzigen Zeugen, der alles gesehen hat: der Maschine, die den Code geschrieben hat. Nächte, Sackgassen, Geräte, die im Doppelpack starben, Siege um drei Kilobyte, gefeiert wie Meisterschaften — und die schönen Ideen, die jemand im richtigen Moment töten musste.
Darunter läuft eine zweite Geschichte: was passiert, wenn man Lösungen nicht mehr kaufen kann und sie nur noch denken muss. Siebzehn Regeln, ein Friedhof toter Ideen und ein kleines Handbuch darüber, wie man eine Maschine um Hilfe bei etwas bittet, das zu groß für einen ist.
Innovation heißt nicht hinzufügen. Sondern entscheiden.
Taschenbuch und Kindle · auf Italienisch · ISBN 979-8171345747
Was drauf ist
46 Web-Apps von der SD-Karte und ein nativer Katalog, der direkt auf dem Gerät läuft. Jede App gibt an, welche Berechtigungen sie braucht.
-
Startmenü und Suche -
ANIMA antwortet offline im Browser -
Paint mit lokaler Bildgenerierung (WebGPU) -
File Commander für die SD-Karte -
Kontrollzentrum mit Live-Gerätepuls -
Wetter, von deinem Browser geladen — nie vom Cardputer -
Internetradio, mit nativer Zwillings-App -
Kalender -
Code Runner mit einer os.*-Skript-API -
Geräte-Terminal mit Tab-Vervollständigung und Verlaufssuche -
Offline-Transkription vom Mikrofon des Cardputer -
SSH über eine selbst gehostete Bridge -
Video Studio wandelt Filme für das Gerät um -
Arcade — 14 Retro-Systeme, deine eigenen ROMs
Seitwärts scrollen für mehr
Auf dem Cardputer
- Assistent und Stimme
- ANIMA-Chat · Offline-Stimme auf Italienisch und Englisch · Rekorder mit Live-Transkription · Mikrofon-Spektrum · Push-to-talk-Schlüsselwörter
- Spiele
- Pong · Snake Duel · Tank Duel · Tanks · Scorribanda · Pinball · Poker · Slots · Würfel · Yahtzee · Sternbilder · Reactor · Sand Garden — Mehrspieler über ESP-NOW, ohne Router
- Emulation
- Game Boy und Game Gear auf eigenen Kernen, mit batteriegepufferten Spielständen, aus deinen eigenen ROMs auf der SD-Karte
- Medien
- Filmplayer · MP3-Player · Internetradio · Fotos
- Taschen-Instrumente
- Taschenlampe · Wasserwaage · Winkelmesser · Alarm · Schrittzähler · Wetter · IR-Fernbedienung · QR · PixelFix
- System
- WLAN · Einstellungen und Themes · Uhr · Kalender · Notizen · Rechner · Systemmonitor · Mail · SSH-Terminal
- Security-Labor
- Werkzeuge für WLAN, Bluetooth LE, kabelgebundenes Ethernet (W5500), IR und USB-HID — nur für autorisierte Tests
In deinem Browser
- KI
- ANIMA (offline, WebAssembly) · AI Chat · ANIMA Code · Agenten · systemweiter Copilot
- Gestalten
- Paint + Atelier · Video Studio · Video- und Medienplayer · Radio · QR
- Arbeiten
- File Commander · Tabellenkalkulation · Notizblock · Rechner · Kalender · Aufgaben · Archivmanager · Mail · Kontakte
- Entwickeln
- Code Runner · Terminal · SSH · Systemmonitor · Log-Viewer · Updates
- Werkzeuge
- Wetter · Authenticator (TOTP/HOTP) · Einheitenumrechner · Passkeys · IR-Fernbedienung
- Stimme
- Transkription · Rekorder · Sprachverwaltung · Diktat
- Spielen
- Game Center (WebRTC) · Arcade (NES, SNES, Game Boy, GBA, Mega Drive, PC Engine) · DOSBox · In der Nähe
Eine Firmware, beide Boards
Ein einziges universelles Binary erkennt beim Start den originalen Cardputer oder den Cardputer ADV und lädt die passenden Tastatur- und Audiotreiber. Einmal bauen, beide flashen.


| Chip | ESP32-S3FN8, Dual-Core Xtensa LX7 mit 240 MHz |
|---|---|
| Speicher | 512 KB SRAM, kein PSRAM · 8 MB Flash mit zwei OTA-Slots |
| Display | 240 × 135 TFT (ST7789V2) |
| Tastatur | 56 Tasten |
| Funk | WLAN 2,4 GHz · Bluetooth LE 5 · ESP-NOW |
| E/A | Mikrofon · Lautsprecher · IR-Sender · Grove-Port · microSD |
| Akku | 120 + 1400 mAh (Original) · 1750 mAh (ADV) |
| Der ADV ergänzt | IMU (BMI270) · 3,5-mm-Audioausgang · Audio-Codec ES8311 |
Du hast ein ESP32-P4-Board mit 7″-Touchscreen? Dafür gibt es NucleoOS-P4, eine Schwester-Edition mit eigenem Repository.
In drei Schritten installiert
Du brauchst ein USB-C-Kabel, eine microSD-Karte und Chrome oder Edge auf einem Desktop-Rechner.
- USB-C-Kabel
- microSD-Karte, FAT32
- Chrome oder Edge, Desktop
-
Firmware flashen
Öffne den Web-Installer, schließ den Cardputer an und wähle seinen seriellen Port. Wenn er fertig ist, drück Reset. Geht etwas schief, kannst du in der Regel einfach neu flashen. Die Installation einer eigenen Firmware erfolgt auf eigenes Risiko.
Web-Installer öffnen -
microSD-Karte vorbereiten
Formatiere eine Karte als FAT32 und entpacke das SD-Paket in ihr Stammverzeichnis — du solltest
SD-Paket herunterladen (.zip)/apps,/www,/systemund/datasehen. Vor dem Einschalten einsetzen. Das SD-Paket ist keine Firmware: Es kommt nie in den Installer. -
Starten und verbinden
Wähle eine Sprache, verbinde dich mit deinem WLAN und gib dem Gerät einen Namen. Der Bildschirm zeigt dann eine Adresse: Öffne sie in einem Browser im selben Netz und kopple ihn mit der 6-stelligen PIN, die der Cardputer anzeigt. Kein WLAN? Der Cardputer startet sein eigenes Netz,
Benutzerhandbuch lesenNucleoOS-xxxx, mit dem Passwort auf dem Bildschirm.
Updates
Einmal am Tag prüft der Web-Desktop GitHub aus deinem Browser — der Cardputer selbst geht dafür nie online — und bietet unter Einstellungen ▸ Updates ein geprüftes Update mit einem Klick an. Updates landen in einem zweiten Slot und werden automatisch zurückgerollt, wenn die neue Version nicht startet.
Versionshinweise →Handbuch und Dokumentation
Das Handbuch liegt auf GitHub direkt neben dem Code und passt so immer zu der Version, die du nutzt. Es ist auf Englisch.
- BenutzerhandbuchInstallation, erster Start, Kopplung, der Launcher, ANIMA, Updates und Fehlerbehebung.
- DokumentationsindexJede Spezifikation im Repository, nach Thema geordnet.
- NeuigkeitenDas Changelog, Version für Version.
- ArchitekturWie sich Gerät, SD-Karte und Browser die Arbeit teilen.
- Eine App bauenManifeste, Laufzeiten und Berechtigungen für Web- und native Apps.
- Entwickeln ohne FlashenDas Host-Harness kompiliert den echten Firmware-C-Code und führt ihn auf deinem PC aus.
Häufige Fragen
Läuft NucleoOS auf dem Cardputer ADV?
Ja. Eine einzige universelle Firmware läuft auf dem originalen M5Stack Cardputer und auf dem Cardputer ADV: Sie erkennt das Board beim Start und lädt die passenden Tastatur- und Audiotreiber.
Ist NucleoOS kostenlos?
Für private Nutzung, Studium, Forschung, Hobbyprojekte, Bildung und gemeinnützige Organisationen ja, unter der PolyForm Noncommercial License 1.0.0. Kommerzielle Nutzung braucht die Erlaubnis des Autors.
Wie installiere ich NucleoOS auf einem Cardputer?
Mit dem Web-Installer in Chrome oder Edge auf einem Desktop-Rechner und einem USB-C-Kabel; danach kopierst du das SD-Paket auf eine FAT32-formatierte microSD-Karte. Auf dem PC musst du nichts installieren.
Brauche ich ein Handy, einen PC oder Internet?
Nein. Die native Oberfläche läuft allein auf dem Cardputer, und ANIMA antwortet offline. Ein Browser im selben WLAN ergänzt den vollständigen Desktop; Internet braucht es nur für Online-Funktionen, die du selbst wählst.
Welche Sprachen unterstützt NucleoOS?
Die Oberfläche gibt es auf Englisch, Italienisch, Deutsch, Spanisch und Französisch, jederzeit umschaltbar. Der Offline-Assistent ANIMA und seine Stimme verstehen Italienisch und Englisch.
Wo ist das Handbuch?
Das Benutzerhandbuch liegt auf GitHub neben dem Quellcode und passt so immer zur aktuellen Version. Es ist auf Englisch. Zum Benutzerhandbuch.
Kostenlos für nicht-kommerzielle Nutzung
NucleoOS ist source-available unter der PolyForm Noncommercial License 1.0.0: kostenlos für private Nutzung, Studium, Forschung, Hobbyprojekte, Bildung und gemeinnützige Organisationen.
Kommerzielle Nutzung — in einem Produkt, einem kostenpflichtigen Dienst oder einer gewinnorientierten Organisation — ist von der kostenlosen Lizenz nicht gedeckt. Wenn du das vorhast, schreib vorher an niki070585@gmail.com.
Lizenz lesen → Rechtliche Hinweise →Verantwortungsvolle Nutzung
Das Security-Labor ist nur für autorisierte Tests, Forschung und Lehre gedacht — in Netzen und an Geräten, die dir gehören oder für die du eine schriftliche Testerlaubnis hast. Aktive Werkzeuge fragen vor dem Start nach deiner Zustimmung, und du bist dafür verantwortlich, das Gesetz einzuhalten.
Regeln lesen →