Un microcontrôleur qui se prend pour une station de travail.
NucleoOS est un système d’exploitation pour le M5Stack Cardputer. Un seul ESP32-S3 avec 512 Ko de RAM et sans PSRAM fait tourner de vraies applications sur son écran 240 × 135 — et sert un bureau complet à n’importe quel navigateur de votre Wi-Fi.







240 × 135 dans la main. Un bureau entier dans le navigateur.
Sur le Cardputer
L’interface native est toujours là, sans téléphone ni PC : un lanceur façon montre connectée, de grands caractères, la recherche pendant la frappe, des sauts de ligne 1–9 dans les listes, des jeux, des médias, des capteurs et le labo de sécurité.
Dans n’importe quel navigateur de votre Wi-Fi
Ouvrez l’adresse affichée par le Cardputer et vous obtenez NucleoOS Web : de vraies fenêtres, un menu Démarrer, des dispositions ancrées, Alt-Tab, le glisser-déposer, un écran de verrouillage et une recherche globale.

L’appareil sert les fichiers. Le travail lourd, c’est votre navigateur qui le fait — jamais les 18 Ko de tas du Cardputer.
ANIMA répond hors ligne. Quand il ne sait pas, il le dit.
ANIMA est l’assistant intégré à NucleoOS. Il ouvre des applications, calcule et convertit, crée des rappels et répond à partir de son propre paquet de connaissances — sans cloud ni modèle de langage. Il est conçu pour ne répondre qu’avec ce qu’il sait, et pour le dire quand il ne sait pas.
-
Vouswhat is 12% of 80
ANIMA12% of 80 = 9.6.
L0 · percent · 95%
-
Vousconvert 10 km to miles
ANIMA10 km = 6.21371 miles.
L0 · convert · 96%
-
Vousopen the calculator
ANIMAOpening calculator.
L0 · open app · 75%
-
Vousremind me to call john tomorrow at 9
ANIMAReminder “call john” tomorrow at 09:00.
L0 · add event · 86%
-
Vouswhat is the capital of mars
ANIMAI don’t know.
no match · abstains
Demandez à ANIMA
Choisissez une question. Ce sont des réponses enregistrées du vrai moteur — la version en direct tourne dans NucleoOS Web.
D’abord le moins coûteux, toujours honnête
- L0
Intentions et FAQ
Moins de 1 ms, aucun accès à la SD, aucun modèle. Couvre 70 à 90 % des demandes du quotidien.
- L1
Recherche binaire
Des embeddings de 64 octets comparés par popcount, puis un reclassement int8 — ne répond qu’au-dessus d’un seuil de confiance.
- L2
Assemblé, jamais inventé
Des passages repris mot pour mot du paquet de connaissances, avec leur source.
- L3
Le cloud, seulement si vous l’autorisez
Un modèle en ligne facultatif. Sinon, ANIMA répond « Je ne sais pas ».
Un cerveau, trois environnements, la même réponse
Le moteur d’ANIMA est écrit une seule fois en C. Un test de parité fait passer chaque requête dans chaque build et exige des réponses identiques à l’octet près.
- ESP32-S3Sur le Cardputer, entièrement hors ligne
- Votre navigateurLe même C, compilé en WebAssembly
- PCLa build hôte sur laquelle tournent les tests
Utilisez le meilleur cerveau à portée de main
Dans le bureau web, ANIMA gravit une échelle de moteurs et vous dit lequel a répondu. Les faits et les commandes — heure, batterie, fichiers, unités, calculs — reçoivent toujours une réponse exacte, jamais celle d’un modèle.
- Cardputer
Toujours là
Le moteur hors ligne en C : recherche, graphe de connaissances, maths et unités. Il n’invente jamais un fait qu’il n’a pas.
- Navigateur
Hors ligne, privé
Le C du Cardputer compilé en WebAssembly — ou un modèle de langage complet sur WebGPU (Qwen3-1.7B).
- Votre PC
Gratuit, sans clé
Ollama, LM Studio, llama.cpp ou Jan sur l’ordinateur depuis lequel vous naviguez. Les Paramètres montrent ce qui tourne et attribuent un modèle à chaque tâche.
- Cloud
Si vous ajoutez une clé
Claude, Groq, Grok ou Gemini, appelés directement depuis votre navigateur. Vos clés restent sur la carte SD du Cardputer.
Un seul réglage. L’agent, les jeux, Paint, l’Enregistreur et la Dictée suivent le même choix — et le mode Privé supprime toute étape Internet pour tous : rien ne quitte votre machine.
512 Ko. Pas de PSRAM. Chaque octet est prévu.
L’ESP32-S3 du Cardputer a 512 Ko de SRAM et aucune RAM externe. NucleoOS garde un noyau fixe et donne le reste à un seul profil de transport à la fois : seule la radio que vous utilisez occupe de la mémoire.
- 80 KBROM de démarrage et données système
- 40 KBFreeRTOS et piles des services
- 16 KBBus d’événements
- 16 KBTampons de la carte SD
- 14 KBÉcran (framebuffers partiels)
- 20 KBEnvironnement des apps et VM d’automatisation
Les apps réservent la mémoire à l’ouverture et la libèrent à la fermeture. Les jeux redémarrent avec un tas neuf. Le bureau web ne coûte presque rien à l’appareil.
Budget de conception tiré de docs/memory-budget.md. Valeurs approximatives.
Le livre : 512 kilooctets
de Nicola Sabaini
Deux mois racontés par le seul témoin qui les a vus en entier : la machine qui a écrit le code. Les nuits, les impasses, les appareils morts en stéréo, les victoires de trois kilooctets fêtées comme des titres — et les belles idées que quelqu’un, au bon moment, a dû décider de tuer.
Dessous court une autre histoire : ce qui arrive quand on ne peut plus acheter les solutions et qu’il ne reste qu’à les penser. Dix-sept règles, un cimetière d’idées mortes et un petit manuel pour demander à une machine de vous aider à faire quelque chose de trop grand pour vous.
Innover, ce n’est pas ajouter. C’est décider.
Broché et Kindle · en italien · ISBN 979-8171345747
Ce qu’il y a dedans
46 apps web servies depuis la carte SD, et un catalogue natif qui tourne sur l’appareil lui-même. Chaque app déclare les autorisations dont elle a besoin.
-
Menu Démarrer et recherche -
ANIMA qui répond hors ligne dans le navigateur -
Paint avec génération d’images en local (WebGPU) -
File Commander pour la carte SD -
Centre de contrôle avec le pouls de l’appareil en direct -
La météo, récupérée par votre navigateur — jamais par le Cardputer -
Radio internet, avec une app native jumelle -
Calendrier -
Code Runner avec une API de script os.* -
Terminal de l’appareil avec complétion Tab et recherche dans l’historique -
Transcription hors ligne depuis le micro du Cardputer -
SSH via une passerelle auto-hébergée -
Video Studio convertit les films pour l’appareil -
Arcade — 14 systèmes rétro, vos propres ROM
Faites défiler sur le côté pour en voir plus
Sur le Cardputer
- Assistant et voix
- Chat ANIMA · voix hors ligne en italien et en anglais · enregistreur avec transcription en direct · spectre du micro · mots-clés push-to-talk
- Jeux
- Pong · Snake Duel · Tank Duel · Tanks · Scorribanda · Cardler · Hordes · Pinball · Poker · Machines à sous · Dés · Yahtzee · Constellations · Reactor · Sand Garden — multijoueur en ESP-NOW, sans routeur
- Émulation
- Game Boy sur notre propre cœur ; Game Gear avec vidéo, son et cartouche écrits par nous autour d’un cœur Z80 éprouvé. Sauvegardes sur pile, à partir de vos propres ROM sur la carte SD
- Médias
- Lecteur de films · lecteur MP3 · radio internet · photos
- Instruments de poche
- Lampe · niveau à bulle · rapporteur · alarme · podomètre · météo · télécommande IR · QR · PixelFix
- Système
- Wi-Fi · réglages et thèmes · horloge · calendrier · notes · calculatrice · moniteur système · courriel · terminal SSH
- Labo de sécurité
- Outils Wi-Fi, Bluetooth LE, Ethernet filaire (W5500), IR et USB-HID — pour des tests autorisés uniquement
Dans votre navigateur
- IA
- ANIMA (hors ligne, WebAssembly) · AI Chat · ANIMA Code · Agents · copilote système
- Créer
- Paint + Atelier · Video Studio · lecteurs vidéo et multimédia · radio · QR
- Travailler
- File Commander · Tableur · Bloc-notes · Calculatrice · Calendrier · Tâches · Gestionnaire d’archives · Courriel · Contacts
- Développer
- Code Runner · Terminal · SSH · Moniteur système · Visionneuse de journaux · Mises à jour
- Outils
- Météo · Authenticator (TOTP/HOTP) · Convertisseur d’unités · Passkeys · Télécommande IR
- Voix
- Transcription · Enregistreur · Gestion de la voix · Dictée
- Jouer
- Game Center (WebRTC) · Arcade (NES, SNES, Game Boy, GBA, Mega Drive, PC Engine) · DOSBox · À proximité
Une galaxie entière, depuis une carte microSD
Costellazioni est le jeu phare : combats 6DOF dans des systèmes stellaires procéduraux, une galaxie à traverser — carte, sauts, amarrages, balises à rallumer — et des mondes où se poser, avec une descente depuis l’orbite sans coupure, huit biomes et des découvertes.
66 peintures et une bande originale en quatre morceaux. Il se joue dans votre navigateur, servi par le Cardputer ; une version native tourne sur le Cardputer lui-même.
Un firmware, les deux cartes
Un seul binaire universel détecte au démarrage le Cardputer d’origine ou le Cardputer ADV et charge les bons pilotes de clavier et d’audio. On compile une fois, on flashe l’un ou l’autre.


| Puce | ESP32-S3FN8, Xtensa LX7 double cœur à 240 MHz |
|---|---|
| Mémoire | 512 Ko de SRAM, sans PSRAM · 8 Mo de flash avec deux emplacements OTA |
| Écran | TFT 240 × 135 (ST7789V2) |
| Clavier | 56 touches |
| Radios | Wi-Fi 2,4 GHz · Bluetooth LE 5 · ESP-NOW |
| E/S | Micro · haut-parleur · émetteur IR · port Grove · microSD |
| Batterie | 120 + 1400 mAh (origine) · 1750 mAh (ADV) |
| L’ADV ajoute | IMU (BMI270) · sortie audio 3,5 mm · codec audio ES8311 |
Vous avez une carte ESP32-P4 avec écran tactile 7″ ? C’est NucleoOS-P4, une édition sœur avec son propre dépôt.
Il s’installe seul. Se met à jour seul. Revient en arrière seul.
Le plus fastidieux avec un firmware personnalisé, c’est tout ce qui vient après le flash. NucleoOS s’en charge — et vérifie son propre travail.
Les nouvelles versions sont annoncées dans le bureau web et sur le Cardputer. L’appareil ne contacte que le site officiel des versions — pour vérifier les versions et télécharger les mises à jour que vous lancez.
Notes de version →La carte SD se remplit seule
Sur une carte vierge ou périmée, l’assistant du premier démarrage télécharge le bureau web et les fichiers d’ANIMA pour votre firmware — un noyau d’environ 50 Mo — et vérifie chaque fichier par SHA-256. Il reprend après une interruption, peut être ignoré et ne touche jamais à vos données.
Des mises à jour firmware réversibles
Un nouveau firmware va dans le second emplacement et ne compte comme installé qu’après avoir tourné sans erreur ses premières secondes. S’il plante avant, le Cardputer revient seul à la version précédente.
La carte se met à niveau depuis le navigateur
Paramètres ▸ Mises à jour indique si l’OS web, les apps et les connaissances d’ANIMA de la carte correspondent au firmware, et les met à jour d’un coup : seulement les fichiers modifiés, chacun vérifié. Vos données, clés et réglages ne sont jamais touchés.
Cohabite avec vos autres firmwares
Vous utilisez déjà M5Launcher ? NucleoOS s’installe comme son invité : les mises à jour passent par le Launcher, il ne peut jamais écraser une autre app installée, et Paramètres ▸ Appareil vous ramène au Launcher.
Un bureau qui s’ouvre vite
Depuis la 0.7.1, le bureau web se charge environ six fois plus vite. Mesuré sur le Cardputer d’origine avec un Wi-Fi faible : environ 5 secondes dans un navigateur neuf, contre plus de 30 auparavant.
Installation en trois étapes
Il vous faut un câble USB-C, une carte microSD et Chrome ou Edge sur un ordinateur de bureau.
- Câble USB-C
- Carte microSD, FAT32
- Chrome ou Edge, ordinateur
-
Flashez le firmware
Ouvrez l’installateur web, branchez le Cardputer et choisissez son port série. À la fin, appuyez sur reset. En cas de problème, il suffit en général de flasher à nouveau. L’installation d’un firmware personnalisé se fait à vos risques.
Ouvrir l’installateur web -
Ajoutez le contenu de la SD
Insérez une microSD en FAT32 avant d’allumer. Une fois le Cardputer sur votre Wi-Fi, l’assistant du premier démarrage télécharge le contenu tout seul — vérifié, reprenable, facultatif. Vous préférez le copier depuis un ordinateur ? Décompressez le paquet SD à la racine de la carte pour voir
Télécharger le paquet SD (.zip)/apps,/www,/systemet/data. Le paquet est du contenu de carte, jamais un firmware. -
Démarrez et connectez-vous
Choisissez une langue, rejoignez votre Wi-Fi et nommez l’appareil. L’écran affiche alors une adresse : ouvrez-la dans un navigateur du même réseau et associez-le avec le code PIN à 6 chiffres affiché sur le Cardputer. Pas de Wi-Fi ? Le Cardputer crée son propre réseau,
Lire le guide utilisateurNucleoOS-xxxx, avec le mot de passe à l’écran.
Autres façons de flasher : avec M5Launcher, qui garde vos autres firmwares — copiez nucleoos-latest.bin sur la carte SD et choisissez-le dans l’installateur SD du Launcher — ou en ligne de commande avec esptool.
Manuel et documentation
Le manuel vit sur GitHub à côté du code : il correspond toujours à la version que vous utilisez. Il est rédigé en anglais.
- Guide utilisateurInstallation, premier démarrage, association, le lanceur, ANIMA, mises à jour et dépannage.
- Index de la documentationToutes les spécifications du dépôt, classées par sujet.
- NouveautésLe changelog, version par version.
- ArchitectureComment l’appareil, la carte SD et le navigateur se partagent le travail.
- Créer une appManifestes, environnements et autorisations pour les apps web et natives.
- Développer sans flasherLe harnais hôte compile le vrai C du firmware et l’exécute sur votre PC.
Questions fréquentes
NucleoOS fonctionne-t-il sur le Cardputer ADV ?
Oui. Un seul firmware universel fonctionne sur le M5Stack Cardputer d’origine et sur le Cardputer ADV : il reconnaît la carte au démarrage et charge les bons pilotes de clavier et d’audio.
NucleoOS est-il gratuit ?
Il est gratuit pour un usage personnel, les études, la recherche, les projets de loisir, l’enseignement et les associations, sous licence PolyForm Noncommercial 1.0.0. L’usage commercial nécessite l’autorisation de l’auteur.
Comment installer NucleoOS sur un Cardputer ?
Avec l’installateur web, depuis Chrome ou Edge sur un ordinateur de bureau et un câble USB-C — ou avec M5Launcher ou esptool. Au premier démarrage, le Cardputer télécharge lui-même le contenu de sa SD ; vous pouvez aussi copier vous-même le paquet SD sur une carte microSD formatée en FAT32. Rien à installer sur le PC.
Puis-je garder mes autres firmwares ?
Oui, avec M5Launcher. Copiez nucleoos-latest.bin sur la carte SD et choisissez-le dans l’installateur SD du Launcher : NucleoOS tourne comme invité à côté de vos autres firmwares, les mises à jour passent par le Launcher, et Paramètres ▸ Appareil propose Retour à M5Launcher.
Faut-il un téléphone, un PC ou internet pour l’utiliser ?
Non. L’interface native fonctionne seule sur le Cardputer et ANIMA répond hors ligne. Un navigateur sur le même Wi-Fi ajoute le bureau complet ; internet n’est utile que pour les fonctions en ligne que vous choisissez.
Quelles langues NucleoOS prend-il en charge ?
L’interface existe en anglais, italien, allemand, espagnol et français, modifiable à tout moment. L’assistant hors ligne ANIMA et sa voix comprennent l’italien et l’anglais.
Où est le manuel ?
Ici même : le guide utilisateur est régénéré depuis le dépôt NucleoOS à chaque mise à jour du site, il correspond donc à la version actuelle. Il est rédigé en anglais.
Gratuit pour un usage non commercial
NucleoOS est source-available sous licence PolyForm Noncommercial 1.0.0 : gratuit pour un usage personnel, les études, la recherche, les projets de loisir, l’enseignement et les associations.
L’usage commercial — dans un produit, un service payant ou une organisation à but lucratif — n’est pas couvert par la licence gratuite. Si c’est votre projet, écrivez à niki070585@gmail.com avant de commencer.
Lire la licence → Mentions légales →Usage responsable
Le labo de sécurité sert uniquement aux tests autorisés, à la recherche et à l’enseignement — sur des réseaux et des appareils qui vous appartiennent ou que vous avez l’autorisation écrite de tester. Les outils actifs demandent votre consentement avant de se lancer, et le respect de la loi relève de votre responsabilité.
Lire les règles →