🤖 MSX IA

Inteligencia Artificial de última generación... en un MSX de los años 80.

MSX IA es, posiblemente, lo más avanzado que puedes hacer hoy con tu MSX2: hablar con las IAs más potentes del momento —Llama, GPT-OSS, Gemini— escribiendo directamente desde el teclado de tu MSX y leyendo sus respuestas en pantalla, en tiempo real, por HTTPS nativo. Sin PC de por medio. Sin proxy. Sin trampa.

Tu MSX2, ese ordenador de 8 bits y Z80 a 3,58 MHz, conectándose por TLS 1.2 a la nube y conversando con una IA. Bienvenido al futuro retro. 🚀

---

✨ ¿Por qué te va a encantar?

• 🌍 Conexión directa a internet desde MSX-DOS, cifrada (HTTPS/TLS), usando el estándar UNAPI TCP/IP. El handshake TLS lo hace el adaptador; tu Z80 solo pide y recibe texto.
• 🧠 3 IAs gratis, a elegir en un menú: cambia de cerebro cuando quieras.
• ⌨️ Experiencia 100% MSX: arrancas IA, escribes tu pregunta, ENTER, y la respuesta aparece formateada a tu pantalla (40 u 80 columnas, con saltos de línea por palabras).
• 🎒 Plug & play: déjalo en una carpeta del PATH y ejecútalo desde donde sea.
• 💸 Coste: 0 €. Las tres IAs tienen plan gratuito sin tarjeta.

---

🕹️ Hardware compatible

Funciona en cualquier MSX2 o superior con un cartucho/adaptador TCP/IP UNAPI con soporte TLS, el hardware moderno que está reviviendo el MSX.

✅ Probado en hardware real:

• GoAuld (firmware ducasp ESP8266-UNAPI con SSL/TLS)
• MSXNano
• MSXPico
• OneChipBook (OCM / SM-X) — ⚠️ debe arrancar en modo BIOS, con la UNAPI BIOS de WiFi activada (pack OCM-SM UNAPI de ducasp). El driver TCP/IP en RAM no incluye TLS y dará el error firmware sin TLS.

🔵 Compatible (aún sin probar — ¿lo pruebas y nos lo cuentas?):

• Obsonet y otros adaptadores con el firmware ducasp ESP8266-UNAPI + TLS
• GR8NET, DenYoNet y demás adaptadores UNAPI TCP/IP v1.1 + TLS
• Otros MSX en FPGA con adaptador UNAPI compatible

Requisitos: MSX-DOS 2 y tu adaptador con IP asignada. Si tu cacharro hace HTTPS por UNAPI, MSX IA funciona.

---

🧠 Elige tu IA

Proveedor	Modelo	Plan gratis
groq	Llama 3.1 8B	~30 peticiones/min, 500K tok/día
cerebras	GPT-OSS 120B	1M tokens/día, ultrarrápido
gemini	Gemini 2.5 Flash	free tier diario de Google

Pon las que quieras: el programa solo muestra en el menú las que tengan clave.

🔑 Consigue tu clave (gratis, sin tarjeta)

• Groq — https://console.groq.com → Create API Key (gsk_...)
• Cerebras — https://cloud.cerebras.ai → API Keys (csk-...)
• Gemini — https://aistudio.google.com/apikey → Create API key (AQ... o AIza...)

---

⚡ Instalación (en 1 minuto)

1. Copia IA.COM a tu disco/SD MSX-DOS. Si lo dejas en una carpeta de tu PATH, podrás lanzarlo desde cualquier sitio.
2. Renombra IA.CFG.sample → IA.CFG y pega tus claves:

   [groq]
   key=gsk_tu_clave_aqui
   
   [cerebras]
   key=
   
   [gemini]
   key=AIza_tu_clave_aqui

   Deja en blanco las que no uses — desaparecen del menú.
3. Asegúrate de que tu adaptador UNAPI está activo y con IP.
4. Escribe:

   IA
   

   ¡y a charlar! 🎉

---

🎮 Uso

Tecla	Acción
Número	Elegir IA en el menú inicial
Texto + ENTER	Enviar tu pregunta
Tecla / ESC en -- mas --	Pasar de página / ver el resto de golpe
F1	Borrar el chat
ESC	Salir

MSX IA detecta el ancho real de tu pantalla y reparte la respuesta con word-wrap por palabras. Las respuestas pueden ser largas (hasta 512 tokens) y se muestran con paginación: cuando llenan la pantalla, pausan con -- mas --; pulsa una tecla para seguir, o ESC para ver el resto de golpe.

---

🔬 Cómo funciona (para los curiosos)

MSX IA habla directamente con las APIs en la nube. El Z80 construye una petición HTTP/1.0 en memoria y la envía por un socket TCP con TLS activado (flag TCPFLAGS_USE_TLS de UNAPI). El adaptador (ESP8266/ESP32 con BearSSL) gestiona todo el cifrado TLS 1.2/1.3 de forma transparente. La respuesta JSON se parsea en el propio MSX y se transliteran los acentos UTF-8 a ASCII.

[Tu MSX2]  --UNAPI TCP+TLS-->  [api.groq.com / cerebras / gemini]
   Z80            cifrado             IA en la nube

• groq y cerebras: endpoint OpenAI-compatible /chat/completions.
• gemini: endpoint nativo :generateContent.
• Busca su IA.CFG en el directorio actual o, si no, en las carpetas del PATH (así funciona lanzándolo desde cualquier sitio).

---

🛠️ Compilar desde fuente

Requiere el entorno msx-unapi-env con MSXgl en WSL (Ubuntu):

cd src/
bash build.sh        # genera ia.com

src/
  ia.c              — programa principal (red, teclado, UI, config)
  net_groq.c/.h     — peticiones HTTP, parser JSON y tabla de proveedores
  msxgl_config.h    — configuracion MSXgl
  project_config.js — build MSXgl (MSX2 / DOS2, RAM en 0x8000)
  lib/network*      — wrapper UNAPI TCP/IP con TLS

---

📦 Versiones

• v1.0 — MSX IA — Multi-proveedor (Groq / Cerebras / Gemini), menú de selección, word-wrap por palabras, auto-detección de pantalla, respuestas largas (hasta 512 tokens) con paginación tipo more, y localización del config desde cualquier carpeta (PATH). Probado en hardware real (GoAuld, MSXNano, MSXPico, OneChipBook).
• v0.1 — Primer cliente Groq por UNAPI TLS, sin proxy.

---

🙌 Créditos

• Idea, dirección, integración y pruebas en hardware real: Papipapito
• Asistencia de programación (firmware Z80 / MSXgl, depuración y documentación): Claude de Anthropic, mediante Claude Code

Un proyecto hecho con cariño para la comunidad MSX. Si lo pruebas en otro adaptador o lo mejoras, ¡los issues y pull requests son bienvenidos! 🕹️

---

🌟 Si tienes un MSX2 con conexión, tienes que probar esto.

Descarga, pon tu clave y pregúntale lo que quieras a una IA... desde 1985. Comparte una foto de tu MSX charlando con la IA — el futuro nunca tuvo tan buen aspecto en 8 bits. 🕹️🤖