Un microcontrolador que se cree una workstation.
NucleoOS es un sistema operativo para el M5Stack Cardputer. Un solo ESP32-S3 con 512 KB de RAM y sin PSRAM ejecuta apps de verdad en su pantalla de 240 × 135 — y sirve un escritorio completo a cualquier navegador de tu Wi-Fi.
240 × 135 en la mano. Un escritorio entero en el navegador.
En el Cardputer
La interfaz nativa siempre está ahí, sin móvil ni PC: un lanzador al estilo smartwatch, letra grande, búsqueda mientras escribes, saltos de fila 1–9 en las listas, juegos, multimedia, sensores y el laboratorio de seguridad.
En cualquier navegador de tu Wi-Fi
Abre la dirección que muestra el Cardputer y tendrás NucleoOS Web: ventanas de verdad, un menú Inicio, diseños acoplados, Alt-Tab, arrastrar y soltar, pantalla de bloqueo y búsqueda global.
El dispositivo sirve los archivos. El trabajo pesado lo hace tu navegador — nunca los 18 KB de heap del Cardputer.
ANIMA responde sin conexión. Cuando no sabe, lo dice.
ANIMA es el asistente integrado en NucleoOS. Abre apps, calcula y convierte unidades, crea recordatorios y responde con su propio paquete de conocimiento — sin nube y sin modelo de lenguaje. Está diseñado para responder solo con lo que sabe, y para decirlo cuando no lo sabe.
-
Túwhat is 12% of 80
ANIMA12% of 80 = 9.6.
L0 · percent · 95%
-
Túconvert 10 km to miles
ANIMA10 km = 6.21371 miles.
L0 · convert · 96%
-
Túopen the calculator
ANIMAOpening calculator.
L0 · open app · 75%
-
Túremind me to call john tomorrow at 9
ANIMAReminder “call john” tomorrow at 09:00.
L0 · add event · 86%
-
Túwhat is the capital of mars
ANIMAI don’t know.
no match · abstains
Pregunta a ANIMA
Elige una pregunta. Son respuestas grabadas del motor real — el de verdad funciona en NucleoOS Web.
Primero lo más barato, siempre honesto
- L0
Intenciones y FAQ
Menos de 1 ms, sin acceso a la SD, sin modelo. Cubre el 70–90 % de las peticiones diarias.
- L1
Búsqueda binaria
Embeddings de 64 bytes comparados con popcount y luego un reordenamiento int8 — solo responde por encima de un umbral de confianza.
- L2
Hilvanado, nunca inventado
Fragmentos tomados al pie de la letra del paquete de conocimiento, con su fuente.
- L3
Nube, solo si lo permites
Un modelo en línea opcional. Si no, ANIMA dice «No lo sé».
Un cerebro, tres entornos, la misma respuesta
El motor de ANIMA se escribe una sola vez en C. Una prueba de paridad pasa cada consulta por cada build y exige respuestas idénticas byte a byte.
- ESP32-S3En el Cardputer, totalmente sin conexión
- Tu navegadorEl mismo C, compilado a WebAssembly
- PCLa build host en la que corren las pruebas
Usa el mejor cerebro que tengas
En el escritorio web ANIMA sube una escalera de motores y te dice cuál ha respondido. Los datos y las órdenes — hora, batería, archivos, unidades, cálculos — se responden siempre con exactitud, nunca con un modelo.
- Cardputer
Siempre ahí
El motor sin conexión en C: búsqueda, un grafo de conocimiento, matemáticas y unidades. Nunca se inventa un dato que no tiene.
- Navegador
Sin conexión, privado
El mismo C del Cardputer compilado a WebAssembly — o un modelo de lenguaje completo en WebGPU (Qwen3-1.7B).
- Tu PC
Gratis, sin clave
Ollama, LM Studio, llama.cpp o Jan en el ordenador desde el que navegas. Ajustes muestra qué se está ejecutando y asigna un modelo a cada tarea.
- Nube
Si añades una clave
Claude, Groq, Grok o Gemini, llamados directamente desde tu navegador. Tus claves se quedan en la tarjeta SD del Cardputer.
Se configura una vez. El agente, los juegos, Paint, la Grabadora y el Dictado siguen la misma elección — y el modo Privado elimina todo paso por Internet en todos ellos: nada sale de tu equipo.
512 KB. Sin PSRAM. Cada byte planificado.
El ESP32-S3 del Cardputer tiene 512 KB de SRAM y ninguna RAM externa. NucleoOS mantiene un núcleo fijo y da el resto a un perfil de transporte cada vez, así solo ocupa memoria la radio que estás usando.
- 80 KBROM de arranque y datos del sistema
- 40 KBFreeRTOS y pilas de servicios
- 16 KBBus de eventos
- 16 KBBúferes de la tarjeta SD
- 14 KBPantalla (framebuffers parciales)
- 20 KBEntorno de apps y VM de automatización
Las apps reservan memoria al abrirse y la liberan al cerrarse. Los juegos se reinician con un heap limpio. Al dispositivo el escritorio web casi no le cuesta nada.
Presupuesto de diseño de docs/memory-budget.md. Cifras aproximadas.
El libro: 512 kilobytes
de Nicola Sabaini
Dos meses contados desde el único punto de vista que los vio enteros: el de la máquina que escribió el código. Las noches, los callejones sin salida, los dispositivos muertos por partida doble, las victorias de tres kilobytes celebradas como campeonatos — y las ideas preciosas que alguien, en el momento justo, tuvo que decidir matar.
Debajo corre otra historia: qué pasa cuando ya no puedes comprar las soluciones y solo te queda pensarlas. Diecisiete reglas, un cementerio de ideas muertas y un pequeño manual sobre cómo pedirle a una máquina que te ayude a hacer algo demasiado grande para ti.
Innovar no es añadir. Es decidir.
Tapa blanda y Kindle · en italiano · ISBN 979-8171345747
Qué trae
46 apps web servidas desde la tarjeta SD y un catálogo nativo que se ejecuta en el propio dispositivo. Cada app declara los permisos que necesita.
-
Menú Inicio y búsqueda -
ANIMA respondiendo sin conexión en el navegador -
Paint con generación de imágenes en local (WebGPU) -
File Commander para la tarjeta SD -
Centro de control con el pulso del dispositivo en directo -
El tiempo, descargado por tu navegador — nunca por el Cardputer -
Radio por internet, con una app nativa gemela -
Calendario -
Code Runner con una API de scripting os.* -
Terminal del dispositivo con autocompletado Tab y búsqueda en el historial -
Transcripción sin conexión desde el micrófono del Cardputer -
SSH a través de un puente alojado por ti -
Video Studio convierte películas para el dispositivo -
Arcade — 14 sistemas retro, tus propias ROM
Desliza de lado para ver más
En el Cardputer
- Asistente y voz
- Chat con ANIMA · voz sin conexión en italiano e inglés · grabadora con transcripción en directo · espectro del micrófono · palabras clave push-to-talk
- Juegos
- Pong · Snake Duel · Tank Duel · Tanks · Scorribanda · Cardler · Hordes · Pinball · Póker · Tragaperras · Dados · Yahtzee · Constelaciones · Reactor · Sand Garden — multijugador por ESP-NOW, sin router
- Emulación
- Game Boy con un núcleo propio; Game Gear con vídeo, sonido y cartucho escritos por nosotros alrededor de un núcleo Z80 probado. Partidas guardadas con batería, desde tus propias ROM en la tarjeta SD
- Multimedia
- Reproductor de películas · reproductor MP3 · radio por internet · fotos
- Instrumentos de bolsillo
- Linterna · nivel de burbuja · transportador · alarma · podómetro · tiempo · mando IR · QR · PixelFix
- Sistema
- Wi-Fi · ajustes y temas · reloj · calendario · notas · calculadora · monitor del sistema · correo · terminal SSH
- Laboratorio de seguridad
- Herramientas de Wi-Fi, Bluetooth LE, Ethernet por cable (W5500), IR y USB-HID — solo para pruebas autorizadas
En tu navegador
- IA
- ANIMA (sin conexión, WebAssembly) · AI Chat · ANIMA Code · Agentes · copiloto del sistema
- Crear
- Paint + Atelier · Video Studio · reproductores de vídeo y multimedia · radio · QR
- Trabajar
- File Commander · Hoja de cálculo · Bloc de notas · Calculadora · Calendario · Tareas · Gestor de archivos comprimidos · Correo · Contactos
- Desarrollar
- Code Runner · Terminal · SSH · Monitor del sistema · Visor de registros · Actualizaciones
- Herramientas
- El tiempo · Authenticator (TOTP/HOTP) · Conversor de unidades · Passkeys · Mando IR
- Voz
- Transcripción · Grabadora · Gestor de voz · Dictado
- Jugar
- Game Center (WebRTC) · Arcade (NES, SNES, Game Boy, GBA, Mega Drive, PC Engine) · DOSBox · Cerca
Una galaxia entera, desde una microSD
Costellazioni es el juego estrella: combate 6DOF en sistemas estelares procedurales, una galaxia que cruzar — mapa, saltos, atraques, balizas que reencender — y mundos donde aterrizar, con un descenso continuo desde la órbita, ocho biomas y descubrimientos.
66 pinturas y una banda sonora original de cuatro temas. Se juega en tu navegador, servido por el Cardputer; una versión nativa funciona en el propio Cardputer.
Un firmware, las dos placas
Un único binario universal detecta al arrancar el Cardputer original o el Cardputer ADV y carga los controladores de teclado y audio adecuados. Compilas una vez y flasheas cualquiera de los dos.
| Chip | ESP32-S3FN8, Xtensa LX7 de doble núcleo a 240 MHz |
|---|---|
| Memoria | 512 KB de SRAM, sin PSRAM · 8 MB de flash con dos ranuras OTA |
| Pantalla | TFT de 240 × 135 (ST7789V2) |
| Teclado | 56 teclas |
| Radios | Wi-Fi 2,4 GHz · Bluetooth LE 5 · ESP-NOW |
| E/S | Micrófono · altavoz · emisor IR · puerto Grove · microSD |
| Batería | 120 + 1400 mAh (original) · 1750 mAh (ADV) |
| El ADV añade | IMU (BMI270) · salida de audio de 3,5 mm · códec de audio ES8311 |
¿Tienes una placa ESP32-P4 con pantalla táctil de 7″? Esa es NucleoOS-P4, una edición hermana con su propio repositorio.
Se instala solo. Se actualiza solo. Vuelve atrás solo.
La parte pesada de un firmware personalizado es todo lo que viene después de flashear. NucleoOS lo hace por ti — y comprueba su propio trabajo.
Las nuevas versiones se anuncian en el escritorio web y en el Cardputer. El dispositivo solo contacta con el sitio oficial de versiones — para comprobar versiones y descargar las actualizaciones que tú inicias.
Notas de la versión →La tarjeta SD se llena sola
En una tarjeta vacía o desactualizada, el asistente del primer arranque descarga el escritorio web y los archivos de ANIMA para tu firmware — un núcleo de ~50 MB — y verifica cada archivo con SHA-256. Se reanuda si se interrumpe, se puede omitir y nunca toca tus datos.
Actualizaciones de firmware con vuelta atrás
El nuevo firmware va a la segunda ranura y solo cuenta como instalado después de funcionar bien sus primeros segundos. Si falla antes, el Cardputer vuelve solo a la versión anterior.
La tarjeta se pone al día desde el navegador
Ajustes ▸ Actualizaciones muestra si el SO web, las apps y el conocimiento de ANIMA de la tarjeta coinciden con el firmware, y los actualiza de una vez: solo los archivos cambiados, cada uno verificado. Tus datos, claves y ajustes nunca se tocan.
Convive con tus otros firmwares
¿Ya usas M5Launcher? NucleoOS se instala como su invitado: las actualizaciones llegan desde el Launcher, nunca puede sobrescribir otra app instalada, y Ajustes ▸ Dispositivo te devuelve al Launcher.
Un escritorio que abre rápido
Desde la 0.7.1 el escritorio web carga unas seis veces más rápido. Medido en el Cardputer original con un Wi-Fi débil: unos 5 segundos en un navegador limpio, donde antes tardaba más de 30.
Instálalo en tres pasos
Necesitas un cable USB-C, una tarjeta microSD y Chrome o Edge en un ordenador de escritorio.
- Cable USB-C
- Tarjeta microSD, FAT32
- Chrome o Edge, escritorio
-
Flashea el firmware
Abre el instalador web, conecta el Cardputer y elige su puerto serie. Cuando termine, pulsa reset. Si algo sale mal, normalmente basta con volver a flashear. Instalar un firmware personalizado es bajo tu propia responsabilidad.
Abrir el instalador web -
Añade el contenido de la SD
Inserta una microSD en FAT32 antes de encender. Cuando el Cardputer esté en tu Wi-Fi, el asistente del primer arranque descarga el contenido solo — verificado, reanudable, omitible. ¿Prefieres copiarlo desde un ordenador? Extrae el paquete SD en la raíz de la tarjeta para ver
Descargar el paquete SD (.zip)/apps,/www,/systemy/data. El paquete es contenido de la tarjeta, nunca un firmware. -
Arranca y conéctate
Elige un idioma, conéctate a tu Wi-Fi y ponle nombre al dispositivo. La pantalla muestra entonces una dirección: ábrela en un navegador de la misma red y vincúlalo con el PIN de 6 cifras que aparece en el Cardputer. ¿Sin Wi-Fi? El Cardputer crea su propia red,
Leer la guía de usuarioNucleoOS-xxxx, con la contraseña en pantalla.
Otras formas de flashear: con M5Launcher, que conserva tus otros firmwares — copia nucleoos-latest.bin en la tarjeta SD y elígelo en el instalador SD del Launcher — o desde la línea de comandos con esptool.
Manual y documentación
El manual está en GitHub junto al código, así siempre coincide con la versión que usas. Está escrito en inglés.
- Guía de usuarioInstalación, primer arranque, vinculación, el lanzador, ANIMA, actualizaciones y solución de problemas.
- Índice de la documentaciónTodas las especificaciones del repositorio, agrupadas por tema.
- NovedadesEl changelog, versión a versión.
- ArquitecturaCómo se reparten el trabajo el dispositivo, la tarjeta SD y el navegador.
- Crea una appManifiestos, entornos y permisos para apps web y nativas.
- Desarrolla sin flashearEl harness host compila el C real del firmware y lo ejecuta en tu PC.
Preguntas frecuentes
¿NucleoOS funciona en el Cardputer ADV?
Sí. Un único firmware universal funciona en el M5Stack Cardputer original y en el Cardputer ADV: detecta la placa al arrancar y carga los controladores de teclado y audio adecuados.
¿NucleoOS es gratuito?
Es gratuito para uso personal, estudio, investigación, proyectos de afición, educación y organizaciones sin ánimo de lucro, bajo la licencia PolyForm Noncommercial 1.0.0. El uso comercial requiere el permiso del autor.
¿Cómo se instala NucleoOS en un Cardputer?
Con el instalador web, desde Chrome o Edge en un ordenador de escritorio y un cable USB-C — o con M5Launcher o esptool. En el primer arranque el Cardputer descarga solo el contenido de la SD; también puedes copiar tú el paquete SD en una microSD formateada en FAT32. No hay que instalar nada en el PC.
¿Puedo conservar mis otros firmwares?
Sí, con M5Launcher. Copia nucleoos-latest.bin en la tarjeta SD y elígelo en el instalador SD del Launcher: NucleoOS funciona como invitado junto a tus otros firmwares, las actualizaciones pasan por el Launcher y Ajustes ▸ Dispositivo ofrece Volver a M5Launcher.
¿Hace falta un móvil, un PC o internet para usarlo?
No. La interfaz nativa funciona sola en el Cardputer y ANIMA responde sin conexión. Un navegador en la misma Wi-Fi añade el escritorio completo; internet solo hace falta para las funciones en línea que elijas.
¿Qué idiomas admite NucleoOS?
La interfaz está en inglés, italiano, alemán, español y francés, y se puede cambiar en cualquier momento. El asistente sin conexión ANIMA y su voz entienden italiano e inglés.
¿Dónde está el manual?
Aquí mismo: la guía de usuario se regenera desde el repositorio de NucleoOS con cada actualización del sitio, así que coincide con la versión actual. Está en inglés.
Gratis para uso no comercial
NucleoOS es source-available con la licencia PolyForm Noncommercial 1.0.0: gratis para uso personal, estudio, investigación, proyectos de afición, educación y organizaciones sin ánimo de lucro.
El uso comercial — en un producto, un servicio de pago o una organización con ánimo de lucro — no está cubierto por la licencia gratuita. Si es lo que tienes en mente, escribe a niki070585@gmail.com antes de empezar.
Leer la licencia → Aviso legal →Uso responsable
El laboratorio de seguridad es solo para pruebas autorizadas, investigación y docencia — en redes y dispositivos tuyos o con permiso por escrito para probarlos. Las herramientas activas piden tu consentimiento antes de ejecutarse, y cumplir la ley es responsabilidad tuya.
Leer las normas →