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
¿Quieres también un modelo de frontera? AI Chat y el copiloto del sistema (Ctrl/⌘ + Espacio) se conectan a Claude, Groq, Grok o Gemini directamente desde tu navegador. Tus claves se quedan en la tarjeta SD del Cardputer.
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 · Pinball · Póker · Tragaperras · Dados · Yahtzee · Constelaciones · Reactor · Sand Garden — multijugador por ESP-NOW, sin router
- Emulación
- Game Boy y Game Gear con núcleos propios, 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
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.
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 -
Prepara la tarjeta microSD
Formatea una tarjeta en FAT32 y extrae el paquete SD en su raíz — deberías ver
Descargar el paquete SD (.zip)/apps,/www,/systemy/data. Insértala antes de encender. El paquete SD no es firmware: nunca va al instalador. -
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.
Actualizaciones
Una vez al día el escritorio web consulta GitHub desde tu navegador — el Cardputer nunca se conecta a internet para ello — y ofrece una actualización verificada con un clic en Ajustes ▸ Actualizaciones. Las actualizaciones se instalan en una segunda ranura y se revierten solas si la nueva versión no arranca.
Notas de la versión →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; después copias el paquete SD en una microSD formateada en FAT32. No hay que instalar nada en el PC.
¿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?
La guía de usuario está en GitHub, junto al código fuente, así siempre coincide con la versión actual. Está en inglés. Leer la guía de usuario.
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 →