AionUi: un escritorio local para coordinar agentes de IA
iOfficeAI/AionUi · 33.116★ · 3.438 forks
Todo lo que hay que saber sobre iOfficeAI/AionUi: una aplicación de escritorio de código abierto que reúne su propio agente y múltiples agentes de línea de comandos en un espacio de trabajo, con automatización, acceso remoto y herramientas para documentos.
Qué es AionUi
AionUi es una aplicación Cowork de escritorio, libre y local, para macOS, Windows y Linux. Su propuesta es que el agente trabaje junto a la persona en el equipo: puede leer y escribir archivos, navegar, utilizar herramientas MCP y automatizar tareas, mientras la interfaz muestra su actividad y solicita autorización cuando corresponde.
Tiene dos formas de uso complementarias. Incluye un motor de agente listo para usar, al que se le proporciona una clave API, y detecta agentes de línea de comandos instalados, entre ellos Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw y Hermes Agent. El README también documenta ejecución paralela, configuración unificada de MCP y un modo de equipos: un agente líder divide el trabajo y lo delega en compañeros que comparten carpeta y tablero de tareas.

No es un proveedor de modelos: admite claves de servicios como OpenAI, Anthropic, Gemini y AWS Bedrock, además de Ollama o LM Studio locales. Por ello el programa es gratuito y Apache-2.0, pero el consumo de las APIs externas sigue dependiendo del proveedor elegido.
El origen: de una interfaz para Gemini CLI a Cowork multagente
La API de GitHub fecha la creación del repositorio el 7 de agosto de 2025. Dos días más tarde, el usuario waili presentó en Hacker News una primera versión como una interfaz gráfica para Gemini CLI; el enlace de aquel envío apuntaba entonces a office-sec/AionUi, mientras que el repositorio actual está en iOfficeAI/AionUi. No recuperé una fuente que identifique con certeza a una única persona fundadora, así que no atribuyo el proyecto a waili más allá de esa presentación.
La evolución visible en el README ayuda a explicar la dirección del proyecto: ya no se presenta solo como interfaz de un agente, sino como una alternativa local y multiplataforma a una aplicación Cowork ligada a un único proveedor. La tensión declarada es práctica: una interfaz que centraliza herramientas heterogéneas, claves de distintos modelos, tareas programadas y acceso desde navegador o mensajería, frente a instalar y configurar cada CLI por separado.
Filosofía y principios
- Local primero: el FAQ del proyecto afirma que los datos se guardan en una base SQLite local y no se suben a sus servidores.

- Elección de modelo y agente: el mismo espacio de trabajo puede usar el agente integrado, agentes CLI externos y proveedores comerciales o locales.
- Control humano de acciones: el README describe aprobaciones por agente; los modos de aprobación automática existen, pero no son el único flujo.
- Automatización persistente: las tareas se pueden vincular a una conversación y ejecutarse por cron, intervalo o una sola vez.
- Extensibilidad explícita: asistentes personalizados, tres capas de habilidades —incluidas, propias y de extensiones—, MCP y CSS permiten adaptar el entorno.
Cómo funciona
La aplicación combina un cliente de escritorio, una interfaz WebUI y un backend local llamado AionCore. El propio repositorio declara que AionUi es el frontal Electron y AionCore el backend local; por eso el desarrollo exige Rust además del entorno TypeScript.

El flujo habitual es: elegir un espacio de trabajo, seleccionar el agente o modelo, conversar y aprobar las operaciones necesarias. Las conversaciones tienen contexto independiente y pueden ejecutarse en paralelo. En modo Equipo, un líder recibe la petición, crea subtareas y delega mediante el servidor MCP de equipos; los compañeros devuelven resultados por un buzón asíncrono y comparten el directorio del proyecto.

Entre las funciones verificadas en la documentación están la vista previa de documentos, código, Markdown, imágenes y diferencias; generación y edición de archivos Office mediante OfficeCLI; gestión de archivos; herramientas MCP; tareas planificadas y canales remotos. La versión v2.1.47-final añadió un navegador dentro del panel de vista previa controlable por el agente mediante un MCP integrado, y una bifurcación de conversaciones con disponibilidad condicionada por las capacidades del agente.

Estado oficial y semioficial
No encontré evidencia de que AionUi esté aceptado en un mercado oficial de Anthropic, OpenAI, Google u otro proveedor de agentes, ni una certificación de estos fabricantes. Por tanto, no debe presentarse como integración oficial de Claude Code, Codex o Gemini CLI: la compatibilidad documentada es la que mantiene el proyecto.
Sí hay una relación semioficial de distribución y colaboración dentro de su propio ecosistema. El README y la cuenta @AionUi anuncian una campaña con Kimi para otorgar planes Allegretto a contribuyentes que cumplan el requisito indicado de tres solicitudes de cambios fusionadas. Asimismo, la versión v2.1.47-final advierte que los instaladores y actualizaciones pasan al sitio oficial y que el paquete de GitHub entra en modo descontinuado para actualizaciones en la aplicación. La misma nota afirma que la migración conserva conversaciones, ajustes y claves API, pero que la nueva distribución exige inicio de sesión. Es un cambio relevante para quien priorice una instalación totalmente autónoma.
El ecosistema
Repositorios de iOfficeAI
La consulta a la API de GitHub recuperó estos proyectos públicos relacionados:
iOfficeAI/OfficeCLI— 25.768 estrellas; suite para que agentes lean, editen y automaticen Word, Excel y PowerPoint sin instalar Office. AionUi la usa para sus asistentes de PPT, Word y Excel.iOfficeAI/AionCore— 82 estrellas; backend local de AionUi, escrito principalmente en Rust.iOfficeAI/AionHub— 37 estrellas; concentrador de extensiones, agentes, habilidades, asistentes y MCP para AionUi.iOfficeAI/aionrs— 113 estrellas; CLI de agente multiproveedor con orquestación de herramientas.iOfficeAI/gemini-cli-pro— 28 estrellas; agente de código para terminal basado en Gemini.
Derivados, adaptaciones y extensiones de la comunidad
La API de bifurcaciones identifica chencore/AionUi con 46 estrellas como la bifurcación más destacada recuperada; conserva la descripción de aplicación Cowork multagente. La búsqueda de repositorios también devolvió adaptaciones con un propósito propio:
CrewBench/CrewBench— 4 estrellas; se describe como una versión de AionUi orientada a programadores. En el hilo de Hacker News de AionUi,sea-goldafirmó que añade observabilidad y protecciones; es una declaración del comentarista, no una auditoría independiente.B33BMO/ArgoUI— 2 estrellas; declara endurecimiento para entornos CMMC con modelos locales, sin telemetría, MCP por entrada/salida estándar y lista de red de bucle local.oliverhees/LokkyWork— sin estrellas en la consulta; se identifica en alemán como edición comunitaria para flujos locales basada en AionUi.alontu/aionui-rtl-patch— sin estrellas en la consulta; parche de derecha a izquierda para hebreo en WebUI mediante proxy inverso y recorrido del DOM.taekchef/AionUI-CSS-Theme-Generator— 11 estrellas; habilidad en chino para generar temas CSS de AionUi.blundrep7909/hermes-setup-v2— 1 estrella; contenedor único para Hermes Agent y la WebUI de AionUi en un VPS de pocos recursos.
Estos repositorios verifican reutilización y localización comunitaria, no soporte, seguridad ni compatibilidad garantizada por iOfficeAI. La gran mayoría de las 3.192 bifurcaciones no se puede clasificar como puerto distinto sin revisar cada una.

Listas e integración adyacente
La búsqueda en GitHub localizó menciones en OpenRouterTeam/awesome-openrouter, Piebald-AI/awesome-gemini-cli, vincentkoc/awesome-openclaw y alvinreal/awesome-openclaw. Las listas acreditan que el nombre aparece en recopilaciones de ecosistemas próximos; no demuestran una asociación oficial con sus mantenedores.
Números del repo
Medición: 5 de agosto de 2026, API de GitHub.
| Métrica | Valor |
|---|---|
| Estrellas | 31.491 |
| Bifurcaciones | 3.192 |
| Suscriptores reales | 135 |
| Incidencias abiertas indicadas por la API | 736 |
| Lenguaje principal | TypeScript |
| Licencia | Apache-2.0 |
| Creación | 7 de agosto de 2025 |
| Última actualización de metadatos | 5 de agosto de 2026 |
| Última versión publicada | v2.1.47-final, 5 de agosto de 2026 |
Los principales contribuidores que devolvió la API fueron IceyLiu (801 contribuciones), kuishou68 (685), piorpua (402), kaizhou-lab (397), zhuqingyv (171) y ringringlin (165). La API general no entregó en esta consulta un total paginado de commits verificable, por lo que se omite en vez de estimarlo. open_issues_count puede incluir solicitudes de cambios abiertas; no equivale necesariamente a incidencias puras. También conviene distinguir los 135 suscriptores de watchers_count, campo que GitHub hace coincidir con las estrellas en la respuesta general.
Cómo contribuir
El proyecto tiene una guía de contribución en inglés y chino. Pide Node.js 22 o superior, Bun, Rust estable con Cargo para AionCore y prek (npm install -g @j178/prek). El flujo básico es bifurcar, crear una rama de funcionalidad, confirmar los cambios, subirla y abrir una solicitud de cambios.
Hay reglas más exigentes que el flujo mínimo del README:
- Cada solicitud debe contener una sola función o corrección no divisible.
- El título y los commits han de usar Conventional Commits en inglés, por ejemplo
fix(preview): restore local html loading. - Antes de subir cambios deben pasar
bun run format,bun run lint,bunx tsc --noEmit, las comprobaciones de internacionalización si proceden ybunx vitest run. - Como alternativa, la guía propone
prek run --from-ref origin/main --to-ref HEADseguido debunx vitest run.
El mantenimiento puede cerrar y pedir reenvío de una solicitud que incumpla estas reglas o extraer sus partes útiles. La campaña con Kimi publicada por el proyecto vincula además el incentivo a tres solicitudes fusionadas, por lo que la contribución tiene una motivación adicional documentada, aunque temporal y sujeta a la campaña.
Cómo lo recibió la comunidad
La recepción externa recuperada es desigual: hay vídeos con audiencia apreciable y conversaciones técnicas, pero Hacker News no muestra un lanzamiento de gran alcance.
- En Hacker News, el envío 46601652, publicado por
wailiel 13 de enero de 2026, alcanzó 2 puntos y 2 comentarios.sea-goldseñaló que CrewBench se construye sobre AionUi y añade observabilidad y protecciones;wailicomparó la relación AionUi–Cowork con la de OpenCode–Claude Code. Son opiniones o descripciones de sus autores, no pruebas comparativas. - Otros envíos directos recuperados fueron 44843792 (2 puntos, 0 comentarios, 9 de agosto de 2025), 45212536 (1 punto, 0 comentarios), 46660044 (1 punto, 0 comentarios) y 48292525 (1 punto, 0 comentarios). Acreditan intentos de presentación, no consenso comunitario.
- La búsqueda de YouTube mostró tutoriales y reseñas: “OpenCode + AionUi: Full Desktop AI Agent to Replace Claude Cowork for Free”, de AI Stack Engineer, con unas 28.000 visualizaciones; “Aion UI Demo: Is This the Ultimate AI Agent Desktop?”, de Fru Dev, con unas 2.500; y “AION UI, THE OPEN SOURCE ANTIGRAVITY 2”, de Darío Fernández, con unas 7.400. El README enlaza además vídeos de Julian Goldie SEO sobre Hermes Agent y OpenClaw, a los que atribuye 27.000 y 11.000 visualizaciones, respectivamente. Son materiales promocionales o tutoriales; no se usan como evaluación independiente.
- En el repositorio sí hay señales concretas de fricción operativa. La incidencia #3809, abierta por
watchfree991, informa un fallo de inicio de OpenCode por agotamiento de tiempo de espera de 30 segundos. La #3832, dewchmike, describe pérdida de mensajes y eventos en WebUI Team hasta reiniciar. La versión más reciente también menciona que la reconstrucción de base de datos requiere una segunda confirmación para evitar borrar datos locales por error, y que se desactiva automáticamente la aceleración por hardware cuando fallan GPU antiguas. Son reportes y medidas del proyecto, no una tasa de fallos medida.
Se intentaron consultas en Reddit —global y en r/programming, r/selfhosted, r/LocalLLaMA, r/devops, r/netsec y r/MachineLearning—, Product Hunt, Dev.to y Hacker News. Product Hunt bloqueó la consulta con una verificación antirobots; no se recuperó una página de lanzamiento verificable. No se recuperaron artículos de Dev.to ni un hilo de Reddit suficientemente verificable para citarlo. Tampoco se halló un paquete npm, PyPI, crates.io o Docker Hub oficial atribuible a AionUi con cifras de descargas.
AionUi frente a otras propuestas
| Propuesta | Coincidencia verificable | Diferencia verificable |
|---|---|---|
| Claude Cowork | Ambos se presentan como un entorno donde un agente actúa en el equipo del usuario. | El README de AionUi afirma compatibilidad con macOS, Windows y Linux, múltiples modelos y agentes CLI, WebUI y cron; el proyecto lo posiciona frente a un flujo ligado a Claude. Esta es la comparación del propio AionUi, no un benchmark externo. |
| OpenCode | AionUi puede detectar e integrar OpenCode como agente CLI. | OpenCode es el agente de línea de comandos; AionUi aporta una interfaz de escritorio, coordinación y capas de acceso remoto sobre agentes ya instalados. |
| CrewBench | Su comentario en Hacker News lo describe como construido sobre AionUi. | sea-gold atribuye a CrewBench observabilidad y protecciones adicionales. La afirmación no fue validada mediante pruebas independientes durante esta investigación. |
peintune/runjam | La búsqueda de GitHub identifica ambos como escritorios unificados para agentes de código. | Runjam se describe como aplicación Tauri/Rust/Vue para Claude Code, Codex CLI y Gemini CLI; AionUi documenta además su agente integrado, OfficeCLI, canales y programación de tareas. |
Guía rápida de uso
Instalación y primer arranque
-
Comprueba los requisitos: macOS 10.15 o posterior, Windows 10 o posterior, o Ubuntu 18.04+, Debian 10+ o Fedora 32+; el README recomienda 4 GB de memoria y 500 MB libres.
-
Descarga el instalador correspondiente desde Releases. Para macOS, el README también ofrece:
brew install aionui -
Abre la aplicación e introduce una clave API. El agente integrado está disponible sin instalar una CLI adicional. Si ya existen Claude Code, Codex, Gemini CLI u otros agentes compatibles, AionUi intenta detectarlos e incorporarlos.
-
Si se desea actualizar desde el paquete
v2.1.47-final, lee primero la nota de distribución: la versión indica que los instaladores nuevos provienen del sitio oficial y que la migración conserva los datos locales, pero requiere inicio de sesión en la nueva distribución.
Flujos de trabajo habituales
- Organizar archivos: abre una conversación en un directorio de trabajo y pide al agente clasificar, renombrar o combinar archivos. La aplicación muestra los cambios y permite usar los permisos por agente.
- Crear un documento editable: selecciona uno de los asistentes de PPT, Word o Excel y formula la petición; el README documenta salidas
.pptx,.docxy.xlsx/.xlsm/.csvgeneradas con OfficeCLI. Examina el resultado en el panel de vista previa antes de reutilizarlo. - Coordinar una tarea de programación: instala y selecciona un agente CLI detectado, activa modo Equipo y da el objetivo al líder. Este reparte subtareas a compañeros con contexto y permisos propios dentro de la carpeta compartida.
- Automatizar un informe periódico: crea una tarea vinculada a una conversación y elige expresión cron de cinco campos —por ejemplo,
0 9 * * 1con zona horaria—, intervalo o ejecución única. Para informes independientes, selecciona crear una conversación nueva en cada disparo; para conservar contexto, continúa la existente.

Configuración esencial
- Configuración de LLM: incorpora la clave de Gemini, OpenAI, Anthropic, Bedrock, Ollama, LM Studio u otro proveedor admitido.
- Configuración de agentes ACP: conecta y prueba los agentes CLI externos que deban aparecer en la interfaz unificada.
- Configuración MCP: configura servidores de herramientas una vez para sincronizarlos con los agentes compatibles.
- Ajustes de WebUI y canales: para acceso remoto, ve a
Settings → WebUI Settings → Channely configura el token del bot; el README cita Telegram, Lark, DingTalk y WeChat. - Habilidades y asistentes: crea habilidades propias en el directorio
skills/y actívalas o desactívalas por conversación; los asistentes se definen mediante archivos Markdown enassistant/.
Trampas frecuentes y soluciones
- Un agente externo no inicia: la incidencia #3809 registra un agotamiento de espera durante el saludo de OpenCode. Comprueba primero la guía de configuración ACP, que el CLI funcione fuera de AionUi y los ajustes del agente estén probados antes de iniciar la conversación.
- WebUI Team parece bloqueada: #3832 reporta pérdida de eventos hasta reiniciar. Si se reproduce, reinicia como solución provisional y conserva el enlace de la incidencia al informar el caso.
- Riesgo de borrado al reconstruir la base: la versión
v2.1.47-finalintrodujo doble confirmación. Lee el aviso antes de aceptar: la aplicación almacena conversaciones y claves localmente. - Aceleración gráfica: las notas de versión explican que puede desactivarse automáticamente en GPU antiguas con controladores obsoletos. Es preferible actualizar el controlador o aceptar el modo sin aceleración antes que interpretar el aviso como un fallo de conversación.
- Actualizaciones: el paquete de GitHub declara modo descontinuado para actualizaciones en la aplicación. Usa la información de migración de la versión actual antes de esperar actualizaciones automáticas desde ese instalador.
Integraciones y migración
AionUi integra agentes CLI mediante ACP, centraliza MCP y puede operar por WebUI o canales de mensajería. También utiliza OfficeCLI para los resultados Office y admite modelos locales mediante Ollama o LM Studio. No hay una guía recuperada de importación desde otro escritorio de agentes; la ruta de migración documentada es la de la distribución antigua de AionUi a la nueva, que conserva conversaciones, preferencias y claves tras el primer inicio de sesión.
Casos de uso y a quién puede ayudar este repositorio
- Personas que ya alternan entre agentes CLI pueden concentrar Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw o Hermes Agent en conversaciones separadas, con detección y configuración MCP centralizada, sin abandonar el agente integrado.
- Equipos pequeños que descomponen trabajo técnico pueden usar modo Equipo: un líder reparte subtareas, los compañeros operan en una carpeta compartida y cada uno mantiene aprobación propia. Es apropiado cuando la tarea se puede dividir y el usuario quiere seguir los permisos y resultados, no para delegación sin supervisión.
- Trabajo administrativo y de contenidos puede beneficiarse de los asistentes y OfficeCLI para generar presentaciones, documentos y hojas de cálculo editables, con previsualización antes de entregar los archivos.
- Automatizaciones personales o de operaciones ligeras pueden enlazar una conversación a un cron, intervalo o disparo único para recopilación de datos, informes, organización de archivos o recordatorios. Es especialmente útil si el equipo permanece disponible; el README describe mecanismos para evitar suspensión y detectar disparos omitidos tras reanudar.
- Usuarios con requisito de acceso remoto pueden usar WebUI y canales documentados para continuar una sesión desde navegador o mensajería, siempre que revisen las implicaciones de exponer un agente con acceso a archivos y mantengan las aprobaciones adecuadas.
Recursos
- Repositorio: https://github.com/iOfficeAI/AionUi
- Sitio oficial: https://www.aionui.com
- Documentación y wiki: https://github.com/iOfficeAI/AionUi/wiki
- Instalación y versiones: https://github.com/iOfficeAI/AionUi/releases
- Guía de agentes ACP: https://github.com/iOfficeAI/AionUi/wiki/ACP-Setup
- Guía de MCP: https://github.com/iOfficeAI/AionUi/wiki/MCP-Configuration-Guide
- Guía de WebUI: https://github.com/iOfficeAI/AionUi/wiki/WebUI-Configuration-Guide
- Cómo contribuir: https://github.com/iOfficeAI/AionUi/blob/main/CONTRIBUTING.md
- Repositorios relacionados: https://github.com/iOfficeAI/OfficeCLI, https://github.com/iOfficeAI/AionCore, https://github.com/iOfficeAI/AionHub, https://github.com/iOfficeAI/aionrs
- Comunidad: https://github.com/iOfficeAI/AionUi/discussions, https://discord.gg/2QAwJn7Egx, https://x.com/AionUi
- Conversaciones: https://news.ycombinator.com/item?id=46601652, https://news.ycombinator.com/item?id=44843792, https://news.ycombinator.com/item?id=48292525
- Vídeos y demostraciones: https://www.youtube.com/watch?v=vWxE6VO9TKo, https://www.youtube.com/watch?v=RgSLdOhICZw, https://www.youtube.com/watch?v=yUU5E-U5B3M, https://www.youtube.com/watch?v=enQnkKfth10
Nota: este artículo combina el README, la wiki, la guía de contribución y las versiones de AionUi, la API y las páginas de GitHub, Hacker News, X y YouTube consultados el 5 de agosto de 2026. Las cifras y la disponibilidad de integraciones cambian con el tiempo.
Comentarios