IA OlympusAsistente de la web
# IA Olympus Agent Installer para Linux Asistente de escritorio para instalar, configurar, probar y mantener agentes de programación compatibles con IA Olympus en Linux x64. La aplicación es local, funciona en el perfil del usuario y no es una web ni un servidor. Sitio oficial del proyecto: <https://iaolympus.com/> ## Estado 1.0.5 - Código fuente completo y autocontenido. - Objetivos de empaquetado: AppImage x86_64 y paquete Debian amd64. - Ocho agentes en el catálogo: Qoder deshabilitado, WorkBuddy/CodeBuddy desktop en modo guiado. - La versión 1.0.5 añade un selector de idioma con dos botones explícitos, `Español` e `English`, con estado activo accesible. También cierra el resumen de instalación al confirmar para que el progreso sea visible en lugar de quedar detrás del diálogo. - Incluye un tutorial web local y bilingüe en [tutorial web/es/index.html](tutorial%20web/es/index.html) y [tutorial web/en/index.html](tutorial%20web/en/index.html), con 24 capturas reales de la aplicación 1.0.5. - En la base 1.0.2, ejecutada en el entorno Linux probado (Debian Bookworm amd64/Xvfb), los siete ejecutables utilizables completaron instalación, configuración, validación de clave y conversación real: Codex, Claude Code, OpenCode, OpenClaw, Hermes, Reasonix y CodeBuddy CLI. Las regresiones 1.0.4 y 1.0.5 no repitieron esa campaña. - La versión 1.0.4 añade la comprobación real del espacio libre del volumen de instalación, con un margen de seguridad de 512 MB y bloqueo únicamente del agente afectado. Si el espacio no se puede medir, la instalación se bloquea en vez de asumir que hay sitio. - La versión 1.0.4 elimina el desplegable de sistema operativo, que solo era un filtro redundante, y lo sustituye por un indicador fijo del equipo. El desplegable de estado sigue siendo un filtro del catálogo y ahora tiene nombres más claros. - La interfaz explica de forma expresa que la app no instala, actualiza, reinstala ni desinstala Node.js. Si falta o es antiguo, solo se bloquea el agente afectado y se ofrece la página oficial y Volver a comprobar. - La versión 1.0.3 añadió un enlace visible a `https://iaolympus.com/` en la bienvenida y en la cabecera. Se abre en el navegador predeterminado mediante el puente IPC restringido a hosts oficiales. - El escritorio de WorkBuddy/CodeBuddy no se certificó. Qoder no se instala ni se anuncia como compatible. - La clave se guarda con Electron `safeStorage` cuando hay llavero; si no, se usa el fallback AES-256-GCM documentado. El directorio seguro usa `0700` y los archivos privados `0600`. - TypeScript PASS, Vitest 102/102, Playwright 4/4 y validador del tutorial PASS en la regresión 1.0.5. - La matriz conversacional de los siete ejecutables se certificó sobre 1.0.2. La 1.0.5 no modifica la lógica conversacional, de red, almacén seguro ni saneado; su regresión revalida compilación, UI de idioma, progreso, empaquetado, arranque del AppImage, instalación/arranque del DEB y el tutorial. - Windows es un proyecto y un artefacto separados. Su candidato 1.0.3 está pendiente de validación en una VM y no se certifica a partir de la evidencia Linux. Consulta [TEST-REPORT-LINUX.md](TEST-REPORT-LINUX.md), [CERTIFICATION.md](CERTIFICATION.md) y [LIMITATIONS.md](LIMITATIONS.md) antes de publicar. ## Artefactos 1.0.5 ```text release/IA-Olympus-Agent-Installer-x86_64.AppImage 108.658.664 bytes release/iaolympus-agent-installer_amd64.deb 98.087.964 bytes ``` SHA-256: ```text aa1da26cb45965bf2ab0a8f8d8ab1e53970b08b9ed9545bc684ed8d775ea91ec IA-Olympus-Agent-Installer-x86_64.AppImage c1a53f39cd7279b570f4128a840d49722e79e5943b09732769d6947134f425aa iaolympus-agent-installer_amd64.deb ``` Ambos artefactos contienen el mismo `resources/app.asar` (1.904.395 bytes, SHA-256 `0ff27c43417f4ff848f7958df3b5d62b7ac8a372947cee89d90f605add8a59b3`). La versión empaquetada es 1.0.5 y contiene el enlace `https://iaolympus.com/`, los dos botones de idioma, el progreso visible, la comprobación de espacio y los mensajes de seguridad de Node.js. No están firmados con GPG. ## Requisitos de desarrollo - Linux x64. La compilación y las pruebas en vivo se realizaron en Debian Bookworm amd64 dentro de Docker. - Node.js 22 o superior y npm 10 o superior. La compilación validada usó Node.js 24.22.1 y npm 11.19.1. - `fakeroot`, `dpkg`, `file`, `xz-utils` y `binutils` para generar el `.deb`. - Chromium de Playwright: `npx playwright install chromium`. - Docker es opcional para compilar desde Windows u otro host. La aplicación empaquetada no necesita Node.js para arrancar. Node.js solo es necesario para los agentes que lo declaran; la aplicación no lo instala en silencio. ## Inicio rápido ```bash cd Linux npm ci npm run typecheck npm test npx playwright install chromium npm run test:e2e npm run build:linux bash scripts/hash-artifacts.sh ``` Si faltan dependencias de empaquetado: ```bash sudo apt-get install fakeroot dpkg file xz-utils binutils ``` Ese `sudo` es solo para preparar el entorno de compilación. La aplicación no usa `sudo` para instalar agentes y explica cualquier elevación antes de solicitarla. ## Compilación reproducible desde Windows con Docker ```powershell cd Linux powershell -ExecutionPolicy Bypass -File scripts/build-in-docker.ps1 ``` El script usa `node:24-bookworm` con las herramientas de empaquetado, ejecuta `npm ci`, typecheck, Vitest y electron-builder en Linux amd64. No instala agentes ni usa la clave del usuario. ## Comandos | Comando | Función | | --- | --- | | `npm run dev` | Electron + Vite en desarrollo | | `npm run dev:renderer` | Renderer aislado para Playwright | | `npm run typecheck` | TypeScript estricto | | `npm test` | 102 pruebas Vitest en 21 archivos | | `npm run test:e2e` | 4 pruebas Playwright | | Tutorial web | Validador PASS: 2 idiomas, 24 capturas, enlaces y hashes | | `npm run build` | Compila `out/` | | `npm run build:linux` | Genera AppImage y DEB x64 | | `npm run build:appimage` | Genera solo AppImage | | `npm run build:deb` | Genera solo DEB | | `npm run build:dir` | Carpeta desempaquetada para inspección | | `bash scripts/hash-artifacts.sh` | Regenera `SHA256SUMS` | ## Arquitectura ```text src/ shared/ catálogo central, requisitos, semver, configuraciones, saneado main/ ventana, IPC, detección, instalación, red, almacén seguro, logs preload/ puente mínimo y tipado mediante contextBridge renderer/ React: lista, detalle, clave, progreso, bienvenida y flujo final tests/e2e/ Playwright con IPC simulado scripts/ build, hash y build en Docker test-results/ evidencia saneada de la certificación Linux ``` El proceso principal concentra las operaciones del sistema. El renderer no tiene acceso directo a Node.js ni al sistema de archivos. El catálogo de agentes está centralizado en `src/shared/catalog.ts` y las recetas de configuración en `src/shared/configs.ts`. ## Rutas de configuración en Linux | Agente | Ruta | | --- | --- | | Codex | `~/.codex/config.toml` | | Claude Code | `~/.claude/settings.json` | | OpenCode | `~/.config/opencode/opencode.json` | | OpenClaw | `~/.openclaw/openclaw.json` | | Hermes | `~/.hermes/config.yaml` | | Reasonix | `~/.reasonix/config.toml` y `~/.reasonix/.env` privado | | WorkBuddy / CodeBuddy | `~/.codebuddy/models.json` | Los agentes npm se instalan en `userData/agent-runtime`, no en paquetes globales. Los accesos directos se crean en `~/.local/share/applications`. Hermes se detecta en `PATH`, `~/.local/bin/hermes` y `~/.hermes/bin/hermes`. ## Seguridad - `contextIsolation`, `sandbox`, CSP, navegación bloqueada y permisos denegados por defecto. - IPC tipado y validado; solo se aceptan IDs, solicitudes y URLs permitidas. - La clave nunca se pasa como argumento visible ni se escribe en la configuración del agente, salvo el `.env` privado requerido por Reasonix. - `GET /v1/models` se usa para validar la cuenta sin consumir tokens. - Los procesos se lanzan con listas de argumentos, `shell: false`, timeout y salida acotada. - Los logs son JSON saneado; no incluyen claves, cabeceras Authorization, cookies, prompts ni respuestas completas. - No se usa `curl|bash`, `iwr|iex`, `setx` silencioso ni `sudo` silencioso. - Los scripts de Hermes se descargan, muestran su SHA-256, requieren consentimiento y se entregan por stdin. - Qoder permanece deshabilitado porque no existe una configuración segura y soportada de URL propia. ## Certificación y límites La etiqueta `live-verified` de los siete ejecutables utilizables significa que existe evidencia de conversación real para la base 1.0.2 en el entorno probado. La regresión 1.0.5 conserva esa lógica sin cambios y revalidó la interfaz de idioma, el progreso, el empaquetado y el tutorial visual. No certifica todos los escritorios Linux, Wayland, un llavero real, la app de escritorio de WorkBuddy/CodeBuddy ni futuras versiones de los agentes. La clave utilizada en la campaña de pruebas se compartió en un chat y debe rotarse o revocarse. No se incluye en el repositorio, los informes, las capturas ni los logs. ## Publicación No se publica nada desde este repositorio ni se modifica la web de IA Olympus. Consulta [PUBLISHING.md](PUBLISHING.md) para firma, hashes, nombres de descarga, avisos de build no firmado y los pasos de publicación autorizados. ## Licencia y terceros Consulta [LICENSE](LICENSE) y [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). La aplicación no reclama licencia sobre los agentes de terceros que instala.