NucleoOS
ENITDEESFR
Installa

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.

Installa dal browser Codice su GitHub

Ultima versione v0.7.3Cardputer e Cardputer ADV · un unico firmware universale · gratis per uso non commerciale

Una M5Stack Cardputer con NucleoOS Una M5Stack Cardputer con NucleoOS
Home — ANIMA viene sempre per primaGiochi — 17 titoli nativiUfficio — orologio, file, noteStrumenti di sistemaCerca mentre scriviCentro di controlloImpostazioniAudio e voce offline
Home — ANIMA viene sempre per primaRender reali dell’interfaccia nativa. Sfoglia con ← → — oppure con , e / come sul dispositivo.Foto del dispositivo © M5Stack; lo schermo è un render reale di NucleoOS.

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 launcher nativo sullo schermo 240 × 135 della Cardputer

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.

  1. Tuquanto fa il 12% di 80

    ANIMAIl 12% di 80 = 9.6.

    L0 · percentuale · 95%

  2. Tuconverti 10 km in miglia

    ANIMA10 km = 6.21371 miglia.

    L0 · conversione · 96%

  3. Tuapri la calcolatrice

    ANIMAApro calculator.

    L0 · apri app · 95%

  4. Turicordami di chiamare giovanni domani alle 9

    ANIMAPromemoria “chiamare giovanni” domani alle 09:00.

    L0 · nuovo evento · 86%

  5. Tuqual è la capitale di marte

    ANIMANon lo so.

    nessuna corrispondenza · si astiene

Risposte reali della build host di ANIMA (v0.4.0), con il livello e la confidenza che riporta.

Prima il costo minimo, sempre l’onestà

  1. L0

    Intenti e FAQ

    Meno di 1 ms, nessun accesso alla SD, nessun modello. Copre il 70–90% delle richieste di tutti i giorni.

  2. L1

    Ricerca binaria

    Embedding da 64 byte confrontati con popcount, poi un riordino int8 — risponde solo sopra una soglia di confidenza.

  3. L2

    Cucito, mai inventato

    Passaggi presi alla lettera dal pacchetto di conoscenza, con la loro fonte.

  4. 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

Usa il cervello migliore che hai

Nel desktop web ANIMA sale una scala di motori e ti dice quale ha risposto. Fatti e comandi — ora, batteria, file, unità, calcoli — hanno sempre una risposta esatta, mai inventata da un modello.

  1. Cardputer

    Sempre presente

    Il motore offline in C: ricerca, un grafo di conoscenza, matematica e unità. Non inventa mai un fatto che non ha.

  2. Browser

    Offline, privato

    Lo stesso C della Cardputer compilato in WebAssembly — oppure un modello linguistico completo su WebGPU (Qwen3-1.7B).

  3. Il tuo PC

    Gratis, senza chiave

    Ollama, LM Studio, llama.cpp o Jan sul computer da cui navighi. Impostazioni mostra cosa è in esecuzione e assegna un modello a ogni compito.

  4. Cloud

    Se aggiungi una chiave

    Claude, Groq, Grok o Gemini, chiamati direttamente dal tuo browser. Le chiavi restano sulla SD della Cardputer.

Lo imposti una volta. L’agente, i giochi, Paint, il Registratore e la Dettatura seguono la stessa scelta — e la modalità Privata toglie ogni passaggio su Internet a tutti loro: niente lascia il tuo computer.

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.

Copertina di 512 KILOBYTE — Storia e regole di un sistema operativo impossibile, di Nicola Sabaini

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.

Compralo su Amazon

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
    Menu Start e ricerca
  • ANIMA che risponde offline nel browser
    ANIMA che risponde offline nel browser
  • Paint con generazione di immagini in locale (WebGPU)
    Paint con generazione di immagini in locale (WebGPU)
  • File Commander per la scheda SD
    File Commander per la scheda SD
  • Centro di controllo con il battito del dispositivo dal vivo
    Centro di controllo con il battito del dispositivo dal vivo
  • Meteo, scaricato dal tuo browser — mai dalla Cardputer
    Meteo, scaricato dal tuo browser — mai dalla Cardputer
  • Radio via internet, con un’app nativa gemella
    Radio via internet, con un’app nativa gemella
  • Calendario
    Calendario
  • Code Runner con un’API di scripting os.*
    Code Runner con un’API di scripting os.*
  • Terminale del dispositivo con completamento Tab e ricerca nella cronologia
    Terminale del dispositivo con completamento Tab e ricerca nella cronologia
  • Trascrizione offline dal microfono della Cardputer
    Trascrizione offline dal microfono della Cardputer
  • SSH tramite un bridge ospitato da te
    SSH tramite un bridge ospitato da te
  • Video Studio converte i film per il dispositivo
    Video Studio converte i film per il dispositivo
  • Arcade — 14 sistemi retrò, con le tue ROM
    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 · Cardler · Orde · Pinball · Poker · Slot · Dadi · Yahtzee · Costellazioni · Reactor · Sand Garden — multigiocatore via ESP-NOW, senza router
Emulazione
Game Boy su un core nostro; Game Gear con video, audio e cartuccia scritti da noi attorno a un core Z80 collaudato. 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

Una galassia intera, da una microSD

Costellazioni è il gioco di punta: combattimento 6DOF in sistemi stellari procedurali, una galassia da attraversare — mappa, salti, attracchi, fari da riaccendere — e mondi su cui atterrare, con la discesa dall’orbita senza stacchi, otto biomi e scoperte da fare.

66 dipinti e una colonna sonora originale in quattro brani. Si gioca nel browser, servito dalla Cardputer; una versione nativa gira sulla Cardputer stessa.

Combattimento in un sistema stellare procedurale
Combattimento in un sistema stellare procedurale
Atterrati accanto a una scoperta su un mondo desertico
Atterrati accanto a una scoperta su un mondo desertico
La mappa della galassia, mentre si traccia un salto
La mappa della galassia, mentre si traccia un salto

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.

Cardputer
Cardputer ADV
Entrambe le schede eseguono la stessa immagine di NucleoOS. Foto dei prodotti © M5Stack; gli schermi sono render reali di NucleoOS.
ChipESP32-S3FN8, Xtensa LX7 dual-core a 240 MHz
Memoria512 KB di SRAM, niente PSRAM · 8 MB di flash con due slot OTA
SchermoTFT 240 × 135 (ST7789V2)
Tastiera56 tasti
RadioWi-Fi 2,4 GHz · Bluetooth LE 5 · ESP-NOW
I/OMicrofono · altoparlante · trasmettitore IR · porta Grove · microSD
Batteria120 + 1400 mAh (originale) · 1750 mAh (ADV)
La ADV aggiungeIMU (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.

Si installa da sé. Si aggiorna da sé. Torna indietro da sé.

La parte noiosa di un firmware personalizzato è tutto quello che viene dopo il flash. NucleoOS lo fa al posto tuo — e controlla il proprio lavoro.

Le nuove versioni vengono annunciate nel desktop web e sulla Cardputer. Il dispositivo contatta solo il sito ufficiale dei rilasci — per controllare le versioni e per scaricare gli aggiornamenti che avvii tu.

Note di rilascio →

  • La scheda SD si riempie da sola

    Su una scheda vuota o vecchia, la procedura del primo avvio scarica il desktop web e i file di ANIMA per il tuo firmware — un nucleo di ~50 MB — e verifica ogni file con SHA-256. Riprende se si interrompe, si può saltare e non tocca mai i tuoi dati.

  • Aggiornamenti firmware che tornano indietro

    Il nuovo firmware va nel secondo slot e conta come installato solo dopo aver girato sano per i primi secondi. Se va in crash prima, la Cardputer torna da sola alla versione precedente.

  • La scheda si allinea dal browser

    Impostazioni ▸ Aggiornamenti mostra se OS web, app e conoscenza di ANIMA sulla scheda corrispondono al firmware, e li aggiorna in un colpo solo: solo i file cambiati, ognuno verificato. Dati, chiavi e impostazioni non vengono mai toccati.

  • Convive con gli altri tuoi firmware

    Usi già M5Launcher? NucleoOS si installa come suo ospite: gli aggiornamenti arrivano dal Launcher, non può mai sovrascrivere un’altra app installata, e Impostazioni ▸ Dispositivo ti riporta al Launcher.

  • Un desktop che si apre in fretta

    Dalla 0.7.1 il desktop web si carica circa sei volte più in fretta. Misurato sulla Cardputer originale con un Wi-Fi debole: circa 5 secondi in un browser pulito, dove prima ne servivano più di 30.

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

  1. 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

  2. Aggiungi il contenuto della SD

    Inserisci una microSD in FAT32 prima di accendere. Quando la Cardputer è sul tuo Wi-Fi, la procedura del primo avvio scarica il contenuto da sola — verificato, riprendibile, saltabile. Preferisci copiarlo da un computer? Estrai il pacchetto SD nella radice della scheda, così vedi /apps, /www, /system e /data. Il pacchetto è contenuto della scheda, mai un firmware.

    Scarica il pacchetto SD (.zip)

  3. 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, NucleoOS-xxxx, con la password sullo schermo.

    Leggi la guida utente

Altri modi per installare: con M5Launcher, che tiene i tuoi altri firmware — copia nucleoos-latest.bin sulla SD e sceglilo dall’installer SD del Launcher — oppure da riga di comando con esptool.

Manuale e documentazione

Il manuale vive su GitHub accanto al codice, così corrisponde sempre alla versione che usi. È scritto in inglese.

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 — oppure con M5Launcher o esptool. Al primo avvio la Cardputer scarica da sola il contenuto della SD; puoi anche copiare tu il pacchetto SD su una microSD formattata in FAT32. Non serve installare nulla sul PC.

Posso tenere gli altri miei firmware?

Sì, con M5Launcher. Copia nucleoos-latest.bin sulla scheda SD e sceglilo dall’installer SD del Launcher: NucleoOS gira come ospite accanto agli altri firmware, gli aggiornamenti passano dal Launcher e Impostazioni ▸ Dispositivo ha Torna a M5Launcher.

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?

Qui sul sito: la guida utente viene rigenerata dal repository di NucleoOS a ogni aggiornamento del sito, quindi corrisponde alla versione attuale. È scritta in inglese.

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 →