Un microcontrollore che si crede una workstation.
NucleoOS è un sistema operativo per M5Stack Cardputer. Un solo ESP32-S3 con 512 KB di RAM e senza PSRAM esegue app vere sul suo schermo 240 × 135 — e serve un desktop completo a qualsiasi browser sulla tua Wi-Fi.
240 × 135 in mano. Un desktop intero nel browser.
Sulla Cardputer
L’interfaccia nativa c’è sempre, senza telefono né PC: un launcher in stile smartwatch, caratteri grandi, ricerca mentre scrivi, salti di riga 1–9 negli elenchi, giochi, media, sensori e il laboratorio di sicurezza.
In qualsiasi browser sulla tua Wi-Fi
Apri l’indirizzo che mostra la Cardputer e trovi NucleoOS Web: finestre vere, un menu Start, layout affiancati, Alt-Tab, trascinamento, blocco schermo e ricerca globale.
Il dispositivo serve i file. Il lavoro pesante lo fa il browser — mai i 18 KB di heap della Cardputer.
ANIMA risponde offline. Quando non sa, lo dice.
ANIMA è l’assistente integrato in NucleoOS. Apre app, fa calcoli e conversioni, imposta promemoria e risponde dal proprio pacchetto di conoscenza — senza cloud e senza un modello linguistico. È progettato per rispondere solo con ciò che sa, e per dirlo quando non lo sa.
-
Tuquanto fa il 12% di 80
ANIMAIl 12% di 80 = 9.6.
L0 · percentuale · 95%
-
Tuconverti 10 km in miglia
ANIMA10 km = 6.21371 miglia.
L0 · conversione · 96%
-
Tuapri la calcolatrice
ANIMAApro calculator.
L0 · apri app · 95%
-
Turicordami di chiamare giovanni domani alle 9
ANIMAPromemoria “chiamare giovanni” domani alle 09:00.
L0 · nuovo evento · 86%
-
Tuqual è la capitale di marte
ANIMANon lo so.
nessuna corrispondenza · si astiene
Chiedi ad ANIMA
Scegli una domanda. Sono risposte registrate dal motore vero — quello dal vivo gira in NucleoOS Web.
Prima il costo minimo, sempre l’onestà
- L0
Intenti e FAQ
Meno di 1 ms, nessun accesso alla SD, nessun modello. Copre il 70–90% delle richieste di tutti i giorni.
- L1
Ricerca binaria
Embedding da 64 byte confrontati con popcount, poi un riordino int8 — risponde solo sopra una soglia di confidenza.
- L2
Cucito, mai inventato
Passaggi presi alla lettera dal pacchetto di conoscenza, con la loro fonte.
- L3
Cloud, solo se lo permetti
Un modello online facoltativo. Altrimenti ANIMA dice “Non lo so.”
Un cervello, tre runtime, la stessa risposta
Il motore di ANIMA è scritto una sola volta in C. Un test di parità esegue ogni domanda su ciascuna build ed esige risposte identiche byte per byte.
- ESP32-S3Sulla Cardputer, completamente offline
- Il tuo browserLo stesso C, compilato in WebAssembly
- PCLa build host su cui girano i test
Vuoi anche un modello di frontiera? AI Chat e il copilota di sistema (Ctrl/⌘ + Spazio) si collegano a Claude, Groq, Grok o Gemini direttamente dal browser. Le tue chiavi restano sulla SD della Cardputer.
512 KB. Niente PSRAM. Ogni byte pianificato.
L’ESP32-S3 della Cardputer ha 512 KB di SRAM e nessuna RAM esterna. NucleoOS tiene un nucleo fisso e dà il resto a un profilo di trasporto alla volta, così occupa memoria solo la radio che stai usando.
- 80 KBROM di avvio e dati di sistema
- 40 KBFreeRTOS e stack dei servizi
- 16 KBBus degli eventi
- 16 KBBuffer della scheda SD
- 14 KBDisplay (framebuffer parziali)
- 20 KBRuntime delle app e VM di automazione
Le app allocano la memoria quando si aprono e la liberano quando si chiudono. I giochi si riavviano con un heap pulito. Il desktop web al dispositivo non costa quasi nulla.
Budget di progetto da docs/memory-budget.md. Valori approssimativi.
Il libro: 512 kilobyte
di Nicola Sabaini
Due mesi raccontati dall’unico punto di osservazione che li ha visti tutti interi: quello della macchina che ha scritto il codice. Le notti, i vicoli ciechi, i device morti in stereo, le vittorie da tre kilobyte festeggiate come scudetti — e le idee bellissime che qualcuno, al momento giusto, ha dovuto decidere di uccidere.
Sotto scorre un’altra storia: cosa succede quando non puoi più comprare le soluzioni e ti resta solo pensarle. Diciassette regole, un cimitero di idee morte e un piccolo manuale su come chiedere a una macchina di aiutarti a fare qualcosa di troppo grande per te.
L’innovazione non è aggiungere. È decidere.
Copertina flessibile e Kindle · ISBN 979-8171345747
Cosa c’è dentro
46 app web servite dalla scheda SD e un catalogo nativo che gira sul dispositivo stesso. Ogni app dichiara i permessi di cui ha bisogno.
-
Menu Start e ricerca -
ANIMA che risponde offline nel browser -
Paint con generazione di immagini in locale (WebGPU) -
File Commander per la scheda SD -
Centro di controllo con il battito del dispositivo dal vivo -
Meteo, scaricato dal tuo browser — mai dalla Cardputer -
Radio via internet, con un’app nativa gemella -
Calendario -
Code Runner con un’API di scripting os.* -
Terminale del dispositivo con completamento Tab e ricerca nella cronologia -
Trascrizione offline dal microfono della Cardputer -
SSH tramite un bridge ospitato da te -
Video Studio converte i film per il dispositivo -
Arcade — 14 sistemi retrò, con le tue ROM
Scorri di lato per vederne altre
Sulla Cardputer
- Assistente e voce
- Chat con ANIMA · voce offline in italiano e inglese · registratore con trascrizione dal vivo · spettro del microfono · parole chiave push-to-talk
- Giochi
- Pong · Snake Duel · Tank Duel · Tanks · Scorribanda · Pinball · Poker · Slot · Dadi · Yahtzee · Costellazioni · Reactor · Sand Garden — multigiocatore via ESP-NOW, senza router
- Emulazione
- Game Boy e Game Gear su core nostri, con salvataggi a batteria, dalle tue ROM sulla scheda SD
- Media
- Lettore di film · lettore MP3 · radio via internet · foto
- Strumenti tascabili
- Torcia · livella · goniometro · allarme · contapassi · meteo · telecomando IR · QR · PixelFix
- Sistema
- Wi-Fi · impostazioni e temi · orologio · calendario · note · calcolatrice · monitor di sistema · posta · terminale SSH
- Laboratorio di sicurezza
- Strumenti Wi-Fi, Bluetooth LE, Ethernet via cavo (W5500), IR e USB-HID — solo per test autorizzati
Nel tuo browser
- IA
- ANIMA (offline, WebAssembly) · AI Chat · ANIMA Code · Agenti · copilota di sistema
- Creare
- Paint + Atelier · Video Studio · lettori video e multimediali · radio · QR
- Lavorare
- File Commander · Foglio di calcolo · Blocco note · Calcolatrice · Calendario · Attività · Gestore archivi · Posta · Contatti
- Sviluppare
- Code Runner · Terminale · SSH · Monitor di sistema · Registro eventi · Aggiornamenti
- Strumenti
- Meteo · Authenticator (TOTP/HOTP) · Convertitore di unità · Passkey · Telecomando IR
- Voce
- Trascrizione · Registratore · Gestione voce · Dettatura
- Giocare
- Game Center (WebRTC) · Arcade (NES, SNES, Game Boy, GBA, Mega Drive, PC Engine) · DOSBox · Vicino
Un firmware, entrambe le schede
Un unico binario universale riconosce all’avvio la Cardputer originale o la Cardputer ADV e carica i driver giusti per tastiera e audio. Compili una volta, installi su tutte e due.
| Chip | ESP32-S3FN8, Xtensa LX7 dual-core a 240 MHz |
|---|---|
| Memoria | 512 KB di SRAM, niente PSRAM · 8 MB di flash con due slot OTA |
| Schermo | TFT 240 × 135 (ST7789V2) |
| Tastiera | 56 tasti |
| Radio | Wi-Fi 2,4 GHz · Bluetooth LE 5 · ESP-NOW |
| I/O | Microfono · altoparlante · trasmettitore IR · porta Grove · microSD |
| Batteria | 120 + 1400 mAh (originale) · 1750 mAh (ADV) |
| La ADV aggiunge | IMU (BMI270) · uscita audio da 3,5 mm · codec audio ES8311 |
Hai una scheda ESP32-P4 con touchscreen da 7″? Quella è NucleoOS-P4, un’edizione sorella con il suo repository.
Installa in tre passi
Ti servono un cavo USB-C, una scheda microSD e Chrome o Edge su un computer desktop.
- Cavo USB-C
- Scheda microSD, FAT32
- Chrome o Edge, desktop
-
Installa il firmware
Apri l’installer web, collega la Cardputer e scegli la sua porta seriale. Alla fine premi reset. Se qualcosa va storto, di solito basta reinstallare. L’installazione di un firmware personalizzato è a tuo rischio.
Apri l’installer web -
Prepara la scheda microSD
Formatta una scheda in FAT32 ed estrai il pacchetto SD nella sua radice — devi vedere
Scarica il pacchetto SD (.zip)/apps,/www,/systeme/data. Inseriscila prima di accendere. Il pacchetto SD non è firmware: non va mai nell’installer. -
Avvia e collegati
Scegli la lingua, collegati alla tua Wi-Fi e dai un nome al dispositivo. Lo schermo mostra poi un indirizzo: aprilo in un browser sulla stessa rete e associalo con il PIN a 6 cifre che compare sulla Cardputer. Niente Wi-Fi? La Cardputer crea una sua rete,
Leggi la guida utenteNucleoOS-xxxx, con la password sullo schermo.
Aggiornamenti
Una volta al giorno il desktop web controlla GitHub dal tuo browser — la Cardputer non va mai online per questo — e propone un aggiornamento verificato con un clic in Impostazioni ▸ Aggiornamenti. Gli aggiornamenti si installano in un secondo slot e tornano indietro da soli se la nuova versione non si avvia.
Note di rilascio →Manuale e documentazione
Il manuale vive su GitHub accanto al codice, così corrisponde sempre alla versione che usi. È scritto in inglese.
- Guida utenteInstallazione, primo avvio, associazione, il launcher, ANIMA, aggiornamenti e risoluzione dei problemi.
- Indice della documentazioneTutte le specifiche del repository, divise per argomento.
- NovitàIl changelog, versione per versione.
- ArchitetturaCome dispositivo, scheda SD e browser si dividono il lavoro.
- Crea un’appManifest, runtime e permessi per app web e native.
- Sviluppa senza flashareL’harness host compila il vero C del firmware e lo esegue sul tuo PC.
Domande frequenti
NucleoOS funziona sulla Cardputer ADV?
Sì. Un unico firmware universale funziona sia sulla M5Stack Cardputer originale sia sulla Cardputer ADV: riconosce la scheda all’avvio e carica i driver giusti per tastiera e audio.
NucleoOS è gratuito?
È gratuito per uso personale, studio, ricerca, hobby, didattica e organizzazioni non profit, con la licenza PolyForm Noncommercial 1.0.0. L’uso commerciale richiede il permesso dell’autore.
Come si installa NucleoOS su una Cardputer?
Con l’installer web, da Chrome o Edge su un computer desktop e un cavo USB-C; poi copi il pacchetto SD su una microSD formattata in FAT32. Non serve installare nulla sul PC.
Servono un telefono, un PC o internet per usarlo?
No. L’interfaccia nativa funziona sulla Cardputer da sola e ANIMA risponde offline. Un browser sulla stessa Wi-Fi aggiunge il desktop completo; internet serve solo per le funzioni online che scegli tu.
Quali lingue supporta NucleoOS?
L’interfaccia è disponibile in italiano, inglese, tedesco, spagnolo e francese, e si cambia in qualsiasi momento. L’assistente offline ANIMA e la sua voce capiscono italiano e inglese.
Dov’è il manuale?
La guida utente è su GitHub, accanto al codice sorgente, così corrisponde sempre alla versione attuale. È scritta in inglese. Leggi la guida utente.
Gratis per uso non commerciale
NucleoOS è source-available con la licenza PolyForm Noncommercial 1.0.0: gratis per uso personale, studio, ricerca, hobby, istruzione e organizzazioni non profit.
L’uso commerciale — in un prodotto, in un servizio a pagamento o in un’organizzazione a scopo di lucro — non è coperto dalla licenza gratuita. Se è quello che hai in mente, scrivi a niki070585@gmail.com prima di iniziare.
Leggi la licenza → Note legali →Uso responsabile
Il laboratorio di sicurezza è solo per test autorizzati, ricerca e didattica — su reti e dispositivi tuoi o che hai il permesso scritto di testare. Gli strumenti attivi chiedono il consenso prima di partire, e il rispetto della legge è una tua responsabilità.
Leggi le regole →