Aggrega
Qué es Aggrega
Aggrega es un compilador de código abierto para la arquitectura de la era de la IA. Describe los componentes de una aplicación y cómo se conectan; Aggrega los convierte, de forma determinista, en los archivos de despliegue que la ejecutan.
- Usa los lenguajes que conoces. Un compilador para los lenguajes que ya usas: entra YAML; salen charts de Helm, manifiestos de Kubernetes y archivos de Compose, Terraform o CloudFormation.
- Los desarrolladores describen, Ops implementa. Los desarrolladores declaran los componentes, sus funcionalidades y quién usa a quién; el equipo de plataforma decide cómo y dónde se ejecuta cada uno.
- Una aplicación, muchas plataformas. La misma aplicación se ejecuta en Docker Compose en un portátil y en Kubernetes en producción: cambiar de destino cambia un mapeo, no tu código.
- Reproducible y gobernado. Misma entrada, misma salida, con cada dependencia fijada en un lockfile. Tus políticas se conectan al compilador y detienen una compilación que las incumple, indicando qué corregir.
Aggrega significa «reúne» en italiano: el nombre dice lo que hace la herramienta, que reúne las partes de una aplicación en una sola descripción.
-
Pega un único prompt en un asistente capaz de ejecutar comandos: instala Aggrega, añade la skill de Aggrega y se conecta al servidor MCP de Aggrega, y te consulta antes de instalar nada.
-
Instala Aggrega, escribe un ejemplo ejecutable en una carpeta y ejecútalo en tu máquina, y luego hazlo crecer paso a paso: un agente de IA sobre un modelo local, o una aplicación web con PostgreSQL.
-
Un recorrido por la documentación en orden de lectura, desde para qué sirve Aggrega hasta la referencia del lenguaje.
Instalación
En Linux y macOS:
curl -fsSL https://aggrega.ai/install.sh | shEn Windows, en PowerShell:
irm https://aggrega.ai/install.ps1 | iexCualquiera de los dos comandos instala el binario aggrega para el usuario actual. Instalación explica lo que hace el comando, además de Homebrew, Scoop, winget y la descarga manual; Conectar el servidor MCP conecta un asistente de IA. La extensión de Aggrega para Visual Studio Code aporta validación, navegación, información al pasar el cursor y autocompletado al YAML de Aggrega, respaldada por el binario aggrega.
La documentación
Documentación orientada a los usuarios del lenguaje y el compilador Aggrega, escrita en inglés y traducida a todos los demás idiomas que ofrece el sitio. Consta de tres partes.
- Arquitectura — el «porqué» de Aggrega. Visión, posicionamiento, modelo mental, pipeline del compilador a nivel conceptual, gobernanza empresarial, catálogo, extensibilidad, decisiones de diseño. En una primera lectura, sigue en orden los capítulos numerados del 01 al 16.
- Guía de redacción — el «cómo sentarse a redactar» de Aggrega. El ciclo de redacción, los cuatro roles que colaboran, la correspondencia entre tipos de entidad y roles, y cómo conectar un asistente de IA mediante el servidor Model Context Protocol. Empieza por Redactar archivos de Aggrega; para que tu asistente de IA instale y configure Aggrega por sí mismo, pega el prompt de Configurar Aggrega con tu asistente de IA.
- Referencia del lenguaje — el «qué» y el «cómo usarlo» de Aggrega. Empieza por Estado del lenguaje para conocer su grado de madurez actual y, en una primera lectura, sigue en orden los capítulos numerados del 01 al 09. Los subdirectorios sin numerar (entities/, vocabulary/, templates/, providers/, plugins/, schema/, cli/, errors/, examples/) son catálogos de referencia — ve directamente a los elementos concretos según los necesites.
Acerca de Aggrega
El compilador Aggrega es de código abierto bajo Apache-2.0, y seguirá siéndolo: no habrá ninguna edición cerrada del compilador, ningún open-core. Todas las funcionalidades del compilador estarán disponibles en la versión de código abierto.
El ecosistema se apoya en cuatro pilares:
- El modelo de separación (inspirado en OAM): una pauta de diseño que separa la intención del desarrollador (el «Qué» y el «Cuánto» abstractos) de la realidad física de Platform Ops (el «Cómo» y el «Dónde» físicos). El compilador no impone esta separación: acepta cualquier patrón de autoría que supere la validación de esquema.
- El DSL semántico & la ontología operativa: los desarrolladores mapean su arquitectura con un conjunto cerrado de primitivas universales de la nube (por ejemplo,
server,worker,stateful-server) en la etiqueta reservadacomponent.aggrega.ai/typede Aggrega. Todo el contexto avanzado—como la autonomía de los agentes de IA, las capacidades generativas o el cumplimiento normativo de los datos—se superpone mediante etiquetas estáticas de Duck-Typing, y un catálogo que clasifica los componentes en un eje propio añade una clave de etiqueta propia. - Políticas programables & validación: el compilador Go central se mantiene sin opiniones propias. La gobernanza corporativa se basa por completo en estándares del sector y en WebAssembly conectable: JSON Schema 2020-12 (escrito mediante una notación abreviada compacta con forma de YAML o en JSON Schema YAML completo) para la validación del catálogo, el rol
label-transformdel socket de gobernanza para el etiquetado dinámico de la topología y sus roles de veredicto para evaluar los límites de seguridad de la arquitectura. - El compilador AOT & la entrega a la ejecución: un pipeline de compilación estricto traduce el DSL en un grafo de representación intermedia (IR) agnóstico respecto a las capacidades. La IR captura la topología de los componentes y las aristas
usesentre ellos (quién usa a quién); el compilador pasa este grafo al socket de gobernanza de WebAssembly (Wasm) para detectar vulnerabilidades de confianza transitivas y, después, ejecuta los plugins de renderizado de Wasm para generar las configuraciones precisas de proxies y guardarraíles. Aggrega escribe estos artefactos en disco y los entrega a otras herramientas, como los pipelines de CI/CD o los orquestadores de tiempo de ejecución, que los despliegan.
Licencia
La documentación de Aggrega se publica bajo la Apache License, Version 2.0; el texto completo está en el archivo LICENSE de su repositorio.