# Instrucciones para el agente: AionUi: una interfaz de escritorio para trabajar con agentes

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/iOfficeAI/AionUi (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/aionui-local-cowork

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba que cumples los [requisitos oficiales](https://github.com/iOfficeAI/AionUi#system-requirements): macOS ≥10.15, Windows ≥10, o Linux Ubuntu ≥18.04 / Debian ≥10 / Fedora ≥32; al menos 500 MB libres y 4 GB de RAM recomendados. Para la alternativa con brew, verifica además que Homebrew está disponible.

### Paso 1: instala la aplicación

Descarga el instalador de tu sistema desde Releases. Como alternativa para macOS, el README indica:

```bash
brew install aionui
```

### Paso 2: configura un proveedor

Abre Settings → Models → Add Model según la [guía oficial de configuración](https://github.com/iOfficeAI/AionUi/wiki/LLM-Configuration). Elige un proveedor para el que tengas acceso, introduce la clave en la interfaz privada y selecciona un modelo de la lista que carga la aplicación. Abre una carpeta con `prueba.txt` y una frase conocida. Pide al agente integrado que lea ese archivo y comprueba la frase. Para otro agente usa [ACP Setup](https://github.com/iOfficeAI/AionUi/wiki/ACP-Setup); requiere instalar y autenticar su CLI por separado.

## Comprobación

La primera consulta debe usar el proveedor seleccionado. Pide una lectura sencilla de un archivo de prueba y verifica el acceso antes de solicitar cambios.

## Si algo falla

Si falla el agente integrado, revisa el proveedor y su acceso. Si falla un agente externo, comprueba antes su CLI y autenticación fuera de AionUi.