Instala tu agente de programación sin tocar la terminal
Esta guía te acompaña desde la descarga hasta la primera conversación con tu agente en Windows 10 u 11. Verás qué hace la aplicación, qué decide tú y qué ocurre en cada botón.
Qué es IA Olympus Agent Installer y qué no es
IA Olympus Agent Installer es una aplicación de escritorio que instala y conecta asistentes de programación con tu cuenta de IA Olympus. Tú eliges el agente; la app se encarga de preparar las dependencias, crear la configuración y comprobar que todo responde.
Lo que puedes esperar
- Detecta qué agentes ya están instalados y cuáles pueden instalarse.
- Instala los agentes de npm en una carpeta privada de tu usuario.
- Escribe la configuración para que el agente use IA Olympus.
- Comprueba la conexión y los modelos disponibles.
- Permite reconfigurar, reparar y desinstalar desde la interfaz.
Lo que no debes esperar
- No instala, actualiza ni desinstala Node.js.
- No desactiva Defender, SmartScreen ni el firewall.
- No ejecuta código que genere un agente.
- No envía telemetría ni datos de uso.
- No convierte en instalable un agente que el producto no soporta, como Qoder.
La app no es un chat. Es el instalador y el panel de control que deja tu agente listo para usarse por separado, desde su propia ventana o terminal.
A quién va dirigido y qué es un «agente»
Un agente es un programa que entiende instrucciones en lenguaje natural y trabaja con tu proyecto: lee archivos, propone cambios y ejecuta tareas cuando se lo pides. Algunos viven en una ventana propia y otros en la terminal.
Este tutorial está pensado para personas que nunca han instalado un agente de programación. No necesitas saber qué es una variable de entorno ni editar archivos de configuración: la app lo hace por ti y te explica cada paso en lenguaje llano.
Principiantes
Quieres probar un asistente sin aprender comandos. Sigue la guía en orden y usa los botones de la app.
Usuarios de Windows
Ya trabajas en Windows 10 u 11 y prefieres una instalación gráfica, sin administrador para los agentes de npm.
Equipos pequeños
Necesitas dejar un agente configurado de forma reproducible y saber después cómo repararlo o retirarlo.
Requisitos reales
| Requisito | Detalle | ¿Obligatorio? |
|---|---|---|
| Sistema operativo | Windows 10 u 11, 64 bits (x64). | Sí |
| Internet | Necesario para descargar el agente, validar la clave y comprobar los modelos. | Sí |
| Cuenta de IA Olympus | Una clave activa con saldo. Sin ella puedes instalar, pero no validar la conexión. | Sí, para usar el agente |
| Espacio libre | Variable según el agente. La ficha muestra el espacio estimado antes de instalar. | Según agente |
| Node.js y npm | Solo para los agentes que lo necesitan. La app detecta la versión y bloquea únicamente al agente afectado. | Según agente |
| WSL2 | Solo para Hermes. Sin WSL2, Hermes no se instala ni se simula. | Solo Hermes |
| Permisos de administrador | No se piden para los agentes de npm. Algunos flujos guiados o WSL2 pueden solicitarlos aparte. | Según caso |
La app comprueba estos requisitos antes de instalar y muestra el resultado en la ficha de cada agente. Un requisito que falta no bloquea a los demás agentes.
Descargar el instalador
Instalador NSIS para Windows x64 · 112.612.361 bytes · SHA-256 verificado
El estado Authenticode de esta versión es NotSigned. Eso no significa que el archivo sea malicioso, pero sí que Windows no puede confirmar quién lo creó. Antes de ejecutarlo, comprueba el SHA-256 y asegúrate de que lo descargaste desde IA Olympus.
Descarga siempre desde una fuente que controles. Si alguien te envía el archivo por mensajería o lo encuentras en un sitio de terceros, verifica el hash antes de abrirlo. En la sección Verificar la descarga tienes el comando exacto.
SmartScreen y las advertencias de Windows
Como el instalador no está firmado, es posible que Windows muestre un aviso de SmartScreen. Ese aviso es una protección normal y no debes desactivarla. Estas son las opciones que verás:
| Lo que ves | Qué significa | Qué hacer |
|---|---|---|
| «Windows protegió tu PC» | Windows no reconoce la firma del archivo. | Comprueba el hash. Si coincide y descargaste desde IA Olympus, puedes continuar conscientemente. |
| «Más información» | Despliega las opciones del aviso. | Léelas antes de decidir. No ejecutes el archivo si no confías en su origen. |
| «Ejecutar de todas formas» | Permite abrir un archivo que Windows no pudo verificar. | Úsalo solo después de verificar el SHA-256. |
No desactives Defender, SmartScreen ni el firewall para «evitar el aviso». Si el archivo viene de un origen desconocido, no lo ejecutes aunque el hash parezca correcto: el hash solo confirma que el archivo es el esperado, no que ese origen sea legítimo.
Instalación por usuario
El instalador es NSIS y está pensado para instalarse solo para tu usuario. No necesita permisos de administrador para la aplicación ni para los agentes de npm, y no modifica el sistema para otros usuarios del equipo.
Abre el archivo descargado
Haz doble clic en
IA-Olympus-Agent-Installer-Setup-x64.exe. Si aparece SmartScreen, aplica lo explicado en la sección anterior.Sigue el asistente
El asistente gráfico te muestra la ruta de instalación y el progreso. No uses un modo silencioso que no esté documentado.
Espera a que termine
Al finalizar se crean los accesos directos y la aplicación se abre. La instalación no descarga agentes por sí sola.
Comprueba la versión
En la app debe aparecer 1.0.4. Si ves otra versión, cierra y vuelve a ejecutar el instalador correcto.
La app avisa antes de cualquier elevación. Los agentes de npm se instalan en una carpeta privada de tu perfil. WSL2 y algunos instaladores guiados pueden pedir permisos de administrador por su cuenta; en ese caso verás el motivo antes de continuar.
Abrir la aplicación
Al terminar la instalación, la app se abre automáticamente. En adelante puedes abrirla desde el menú Inicio o desde el acceso directo del escritorio. La primera pantalla es la bienvenida:
La bienvenida no instala nada. Solo presenta el flujo y recuerda que la app no instala Node.js en silencio ni envía telemetría. Puedes cerrarla y volver a abrirla cuando quieras.
Cambiar entre español e inglés
En la cabecera hay dos botones: Español e English. El idioma activo queda resaltado y la preferencia se conserva al cerrar y volver a abrir la app. El cambio afecta a toda la interfaz, no solo a los títulos.
Si estás leyendo esta guía en español pero tu app está en inglés, pulsa «Español». Si prefieres inglés, pulsa «English». Los nombres de los agentes y de los modelos no se traducen.
Los ocho agentes y sus estados
La lista de la izquierda muestra ocho agentes. Arriba tienes un buscador, un filtro por estado y el indicador fijo Este equipo: Windows, que confirma el sistema detectado.
Qué significa cada estado
| Estado | Qué significa | Qué puedes hacer |
|---|---|---|
| Disponible | Los requisitos se cumplen y el agente puede instalarse. | Pulsar «Instalar». |
| Requiere Node.js | Falta Node.js o la versión detectada no llega al mínimo del agente. | Abrir la página oficial de Node.js y volver a comprobar. La app no lo instala. |
| Requiere WSL2 | El agente se ejecuta dentro de un entorno Linux y WSL2 no está disponible. | Leer la explicación y abrir la guía oficial. |
| Requiere instalación guiada | No hay un instalador silencioso fiable; hay que seguir el flujo oficial del fabricante. | Abrir la descarga oficial y volver a comprobar después. |
| Ya instalado | La app detectó el programa con una versión válida. | Reconfigurar, reparar, probar conexión o desinstalar. |
| No disponible | El producto actual no permite configurarlo contra IA Olympus. | Nada: no se instala ni se configura. |
| Requiere permisos de administrador | El flujo necesita elevación y la app lo avisa antes. | Revisar el motivo y decidir si continúas. |
Los ocho agentes
| Agente | Para qué sirve | Estado observado en la captura |
|---|---|---|
| Codex | Lee tu proyecto, propone cambios y ejecuta tareas de programación. | Ya instalado · 0.164.0 |
| Claude Code | Agente conversacional para programar con contexto desde la terminal. | Disponible con Node.js 24.22.1 |
| OpenCode | Agente de terminal para conversar con tu proyecto y cambiar código. | Disponible |
| OpenClaw | Memoria y canales sobre tu propio equipo, con un servicio local. | Disponible si Node.js cumple el rango |
| Hermes | Memoria persistente y habilidades reutilizables dentro de WSL2. | Requiere WSL2 |
| Reasonix | Trabaja desde la terminal con proveedores declarados por ti. | Disponible |
| WorkBuddy / CodeBuddy | Aplicación y CLI con modelos personalizados. | Requiere instalación guiada |
| Qoder | Asistente que no admite una URL base propia en esta versión. | No disponible |
El estado depende de tu equipo. En una máquina con otra versión de Node.js, Claude Code u OpenClaw pueden aparecer bloqueados y el resto seguir disponible.
Elegir un agente e instalar
Selecciona un agente en la lista. A la derecha verás su ficha con una explicación para principiantes, para qué sirve, qué necesitas, qué se instalará y dónde. Si todo está correcto, el botón Instalar se activa.
El resumen no instala. «Instalar ahora» es la confirmación final. Si cancelas en el resumen, no se escribe nada. Si la instalación falla, la app muestra el error y permite reintentar sin dejar el agente a medias.
En una máquina donde el agente ya existe, la app no duplica la instalación: muestra Ya instalado y ofrece Reconfigurar, Reparar, Probar conexión y Desinstalar. Ese es el caso de Codex en esta captura.
Tu clave de IA Olympus
Para conectar el agente con tu cuenta necesitas una clave de IA Olympus. Empieza por sk-iaolympus-. La app la pide en un diálogo con campo de contraseña, botón Pegar y control Mostrar/Ocultar.
Cómo se trata tu clave
- La app recorta los espacios sobrantes antes de validar.
- Una clave con un prefijo incorrecto se rechaza localmente, sin enviarla a la red.
- El resultado de la validación no revela la clave ni su contenido.
- La clave se guarda en el almacén seguro del sistema, no en los archivos de configuración de los agentes.
- Puedes borrarla desde la interfaz cuando quieras.
No la pegues en chats, correos, capturas, informes ni repositorios. Si sospechas que se ha expuesto, revócala o rótala desde tu cuenta y guarda una nueva.
Cuando un agente admite variables de entorno, su configuración guarda una referencia a IAOLYMPUS_API_KEY y la clave se inyecta solo en el proceso del agente. La única excepción documentada es el archivo privado de Reasonix, protegido con permisos del usuario.
Instalado, configurado y conexión validada
Son tres cosas distintas y la app las muestra por separado. No llames «listo» a un agente solo porque su archivo de configuración exista.
| Estado | Qué demuestra | Qué no demuestra |
|---|---|---|
| Instalado | El programa está presente y responde con una versión. | Que esté conectado a IA Olympus. |
| Configurado | La app escribió la configuración de IA Olympus en la ruta correcta. | Que la cuenta funcione o que la clave sea válida. |
| Conexión validada | La clave funciona y /v1/models devuelve los modelos esperados. | Que el agente haya mantenido una conversación. |
La captura 09-success.png no se obtuvo porque exige una clave real y una conexión validada, y en esta pasada no se usó ninguna clave real ni se levantó un servicio simulado. No se ha fabricado una imagen. La pantalla final muestra los tres estados anteriores por separado; puedes comprobarlos en tu propia instalación tras validar la clave.
Prueba de conexión y modelos
El botón Probar conexión hace una petición GET /v1/models a IA Olympus. Si la clave es válida y hay red, la respuesta es HTTP 200 y contiene exactamente dos modelos públicos:
iaolympus-lowiaolympus-pro
La prueba no gasta tokens de conversación: solo comprueba que la cuenta responde y qué modelos están disponibles. No envía prompts ni ejecuta código.
Si no hay conexión, la app muestra un mensaje específico de red, distinto de «clave inválida». Eso te ayuda a saber si el problema es tu Internet o la credencial. Si la clave es correcta pero no tiene saldo, el mensaje también es distinto.
Conexión validada, los dos modelos y la fecha de la última comprobación. Si borras la clave, esa marca desaparece y el agente vuelve a pedir una clave para probar la conexión.
Qoder: no disponible en esta versión
Qoder aparece en el catálogo para que sepas que existe, pero está marcado como No disponible. El producto actual no permite usar una URL base propia, así que la app no puede conectarlo con IA Olympus.
No intentes forzar su instalación ni cambiar su configuración a mano para apuntarlo a IA Olympus. Si en el futuro el producto admite una URL base propia, la app lo indicará con una versión nueva.
WorkBuddy / CodeBuddy: instalación guiada
WorkBuddy / CodeBuddy no tiene un instalador silencioso oficial fiable. Por eso la app no finge una instalación automática: te ofrece la descarga oficial, te explica los pasos y comprueba después si el programa aparece instalado.
Abre la descarga oficial
La app abre la página del fabricante. Descarga desde ahí, no desde un espejo.
Completa el instalador del fabricante
Sigue sus pasos. Puede pedir permisos de administrador; es su propio instalador, no el de IA Olympus.
Vuelve a la app y comprueba
Pulsa «Volver a comprobar». Si la app detecta el programa, habilita la configuración de IA Olympus.
Configura y prueba
Solo entonces se escribe la configuración y se puede probar la conexión.
Si el fabricante cambia su instalador, la app puede no detectarlo. En ese caso la certificación queda como «guiada» y no como instalación automática verificada.
Hermes y WSL2
WSL2 permite ejecutar un pequeño entorno Linux dentro de Windows, como una ventana aparte. Hermes se instala dentro de ese entorno, así que sin WSL2 no puede funcionar. La app no simula que esté instalado solo porque exista un archivo de configuración.
Cómo prepararlo
Abre la guía oficial
El botón «Abrir guía de WSL2» lleva a la documentación de Microsoft. Léela antes de ejecutar comandos.
Instala WSL2 con su permiso
El proceso puede pedir administrador y reiniciar Windows. Hazlo solo si estás de acuerdo y tienes una copia o instantánea de la VM.
Vuelve a comprobar
Después del reinicio, abre la app y pulsa «Volver a comprobar». Si WSL2 y una distribución están disponibles, se habilita la instalación de Hermes.
Instala Hermes dentro de WSL2
La app escribe la configuración y comprueba que el programa responde de verdad. No se marca instalado solo por tener la configuración.
En esta máquina de captura WSL2 no estaba disponible. Por eso Hermes queda documentado y pendiente de prueba real, no certificado.
Node.js: la app no lo toca
Varios agentes están escritos en JavaScript y necesitan Node.js, que es el programa que los ejecuta. La app nunca instala, actualiza, reinstala ni desinstala Node.js. Solo lo detecta y comprueba la versión.
| Situación | Qué hace la app | Qué haces tú |
|---|---|---|
| Node.js no está instalado | Marca «Requiere Node.js» solo en los agentes que lo necesitan. Los demás siguen disponibles. | Abrir la página oficial de Node.js desde la app, instalar la versión recomendada y volver a comprobar. |
| La versión es antigua | Muestra la versión detectada, el mínimo requerido y bloquea ese agente. | Actualizar Node.js desde el sitio oficial y volver a comprobar. |
| La versión cumple | Muestra la versión detectada y permite instalar. | Continuar con la instalación del agente. |
Los mínimos dependen del agente. Por ejemplo, Claude Code exige Node.js 22 o superior y OpenClaw exige una rama concreta: >=24.22.1 <25 o >=26.12.1. Si no se cumple, OpenClaw queda bloqueado y no se instala a la fuerza.
La app instala los agentes de npm en una carpeta privada de tu usuario y no pide permisos de administrador para ello. Si un agente requiere otro método, lo indica antes de continuar.
Mantenimiento: reconfigurar, reparar, probar y desinstalar
Cuando un agente ya está instalado, su ficha cambia de «Instalar» a un conjunto de acciones de mantenimiento. No se duplica la instalación existente.
Reconfigurar
Vuelve a escribir la configuración de IA Olympus. No duplica bloques ni líneas: sustituye lo que ya había escrito la app. Úsalo si cambiaste de clave o de modelo.
Reparar
Corrige una configuración dañada o incompleta. Conserva la configuración ajena que ya existiera y, si hace falta, crea una copia de seguridad antes de tocar nada.
Probar conexión
Comprueba la clave y los modelos con GET /v1/models. No gasta tokens y no ejecuta el agente.
Desinstalar
Retira el paquete que gestionó la app, su configuración de IA Olympus y su acceso directo. No elimina una instalación global que ya existiera antes y no creara la app.
Si un agente tiene configuración ajena —por ejemplo, otro proveedor declarado por ti—, Reparar no la borra. La app solo toca el bloque que ella misma administra.
Seguridad y privacidad
- HTTPS: la comunicación con IA Olympus viaja cifrada. La app no desactiva la validación de certificados.
- Almacén seguro: la clave se guarda con el almacén protegido del sistema, no en texto plano dentro del proyecto.
- Sin telemetría: la app no envía datos de uso ni analíticas.
- Logs saneados: los registros no incluyen la clave, cabeceras de autorización, cookies, prompts completos ni respuestas completas.
- Configuración mínima: los agentes apuntan solo a IA Olympus y referencian
IAOLYMPUS_API_KEY, salvo el archivo privado de Reasonix. - Sin código generado: la app no ejecuta código que produzca un agente.
No compartas la clave, no la guardes en repositorios y no la pegues en capturas. Si se expone, revócala o rótala y vuelve a validar desde la app.
Solución de problemas
| Problema | Qué ves | Qué hacer |
|---|---|---|
| SmartScreen bloquea el instalador | «Windows protegió tu PC». | Verifica el SHA-256 y el origen. No desactives la protección. Si no confías, no lo ejecutes. |
| Sin Internet | Mensaje específico de red al validar la clave. | Comprueba la conexión, vuelve a intentarlo y distingue este error de una clave inválida. |
| Falta Node.js | «Requiere Node.js» en la ficha del agente. | Abre la página oficial desde la app, instala Node.js y pulsa «Volver a comprobar». |
| Node.js es antiguo | Versión detectada por debajo del mínimo. | Actualiza desde el sitio oficial. No fuerces la instalación del agente. |
| WSL2 no disponible | «Requiere WSL2» en Hermes. | Lee la explicación, abre la guía oficial y vuelve a comprobar tras instalarlo. |
| Clave inválida o sin saldo | Error claro, sin mostrar la clave. | Revisa el prefijo, vuelve a pegar la clave y comprueba el saldo de tu cuenta. |
| La instalación falla | Error con la fase y el motivo. | Reintenta desde la app. Si persiste, usa Reparar o desinstala y vuelve a empezar. |
| La app no abre | No aparece la ventana. | Cierra cualquier proceso residual, vuelve a abrir desde Inicio y, si sigue igual, reinstala la app. |
Comprueba que no queda una ventana abierta en segundo plano. Reinstalar no borra tus agentes ni la configuración ajena, pero es mejor cerrar la app correctamente.
Preguntas frecuentes
¿Necesito saber programar para usar esto?
No. La app instala y configura por ti. Programar es lo que harás después con el agente, si quieres; el tutorial solo cubre la puesta en marcha.
¿La app es un chat?
No. Es el instalador y el panel de control. Una vez configurado, abres el agente por separado desde su acceso o su terminal.
¿Puedo usar varios agentes a la vez?
Sí. Cada uno se instala y configura por separado. La clave es la misma y la app comprueba el estado de cada ficha de forma independiente.
¿La clave se guarda en los archivos del agente?
No, salvo el archivo privado de Reasonix, que es la excepción documentada. El resto de configuraciones referencia IAOLYMPUS_API_KEY y la clave se inyecta solo en el proceso.
¿Qué pasa si borro la clave?
La app elimina la clave del almacén seguro y las marcas de validación. Los agentes siguen instalados y configurados, pero no podrán autenticarse hasta que introduzcas una clave nueva.
¿Desinstalar un agente borra mi configuración ajena?
No. La app retira solo lo que ella gestiona. Si tenías otra configuración o una instalación global previa, se conserva.
¿Puedo usar Qoder?
No en esta versión. El producto no admite una URL base propia y la app lo mantiene como No disponible.
¿Por qué el instalador no está firmado?
Es el estado de este build: Authenticode NotSigned. Verifica el SHA-256 y descarga solo desde IA Olympus. No desactives SmartScreen.
¿La app envía datos a algún sitio?
No envía telemetría. Solo contacta con IA Olympus para validar la clave y comprobar los modelos cuando tú lo pides.
Verificar la descarga
El SHA-256 es una huella del archivo. Si coincide con la esperada, el archivo es exactamente el que se publicó. Puedes calcularlo en PowerShell:
Get-FileHash -LiteralPath .\IA-Olympus-Agent-Installer-Setup-x64.exe -Algorithm SHA256Valor esperado para la versión 1.0.4:
4eef6a0737ba443dca8f8882b51fcb07fef55c5fbf58161db7d6d549c192cc41
| Dato | Valor esperado |
|---|---|
| Archivo | IA-Olympus-Agent-Installer-Setup-x64.exe |
| Versión | 1.0.4 |
| Tamaño | 112.612.361 bytes |
| SHA-256 | 4eef6a0737ba443dca8f8882b51fcb07fef55c5fbf58161db7d6d549c192cc41 |
| Firma Authenticode | NotSigned |
Enlaces de descarga y lista de comprobación:
Limitaciones y estados no certificados
- Sin clave real: esta pasada no usó ninguna clave real. La validación de cuenta y la pantalla final de éxito no se capturaron;
09-success.pngno existe y no se ha fabricado. - Sin servicio simulado: no se alteró el archivo hosts, no se instaló un certificado local y no se desactivó la validación TLS.
- Instalación no completada: la captura de progreso es real, pero «Instalar ahora» no se pulsó. No se certifica una instalación de agente de principio a fin.
- Codex preinstalado: el equipo de captura ya tenía Codex 0.164.0. Se documenta el flujo «Ya instalado / Reconfigurar / Reparar», no una instalación desde cero.
- Hermes: sin WSL2 disponible, queda como documentación y pendiente de prueba en vivo.
- WorkBuddy / CodeBuddy: la instalación es guiada y no se completó en la captura; queda como flujo guiado, no como instalación automática certificada.
- Qoder: no disponible por diseño. No se instala, no se configura y no se redirige.
- Conversación: no se ejecutaron pruebas conversacionales con agentes; este tutorial no las certifica.
Estas limitaciones no afectan a lo que sí se muestra: la interfaz real de la versión 1.0.4, los estados reales del equipo de captura y los flujos que la app ofrece.