# Aggrega

> Aggrega es un compilador de código abierto para infraestructura como código: una única descripción YAML de tu aplicación se convierte en archivos de Kubernetes, Helm, Compose, Terraform o CloudFormation que revisas y que son tuyos.

URL: https://aggrega.ai/es/

## Describe la arquitectura una vez. Obtén el código de infraestructura para cada plataforma que usas.

Aggrega es un compilador de código abierto para infraestructura como código: una única descripción YAML de tu aplicación se convierte en archivos de **Kubernetes**, **Helm**, **Compose**, **Terraform** o **CloudFormation** que revisas y que son tuyos.

¿Ya has creado un agente con **LangGraph**, **CrewAI**, **n8n**, **Dify** u otros? Impórtalo.

[Configurar con tu asistente de IA](https://aggrega.ai/es/#ai-assistant)[Inicio rápido](https://aggrega.ai/docs/es/getting-started/)[Importar tu proyecto](https://aggrega.ai/es/#import)

Linux y macOS

curl -fsSL https://aggrega.ai/install.sh | sh

Windows, en PowerShell

irm https://aggrega.ai/install.ps1 | iex

Dos ejemplos de inicio rápido, construidos paso a paso: un agente de IA sobre un modelo local y una aplicación web con PostgreSQL. Cada paso muestra los archivos que cambia con las líneas que añade, el comando aggrega build y los archivos que escribe la compilación.

### Funciona con tu asistente de IA

Pega este prompt en un asistente que pueda ejecutar comandos y este instalará Aggrega, se añadirá la habilidad de Aggrega y se conectará al servidor MCP de Aggrega. El prompt le hace consultarte antes de instalar nada.

El prompt

Configura Aggrega para mí, paso a paso, y dime qué ejecutaste en cada paso.

1. Ejecuta `aggrega version`. Si no se encuentra el comando, pregúntame antes de instalar Aggrega y luego instálalo para mi usuario con el instalador oficial: en Linux o macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, en Windows en PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Vuelve a ejecutar `aggrega version`. Si el instalador mostró una línea para añadir a mi `PATH`, muéstramela.

2. Si `https://aggrega.ai/docs/ai-assistants/skill/` indica una forma de instalar el plugin de Aggrega en ti, pregúntame antes de instalarlo, y luego instálalo de esa forma, o dime qué hacer cuando se trate de un paso que realizo yo en tu interfaz. El plugin añade la skill de Aggrega y te conecta al servidor MCP de Aggrega. De lo contrario, ejecuta `aggrega skills install --help` y busca tu propio identificador en la lista que imprime. Pregúntame si quiero la skill en este proyecto o en todos los proyectos, y luego ejecuta `aggrega skills install --agent <your identifier>`, añadiendo `--global` para todos los proyectos. Si no estás en la lista, omite la instalación de la skill y dímelo.

3. Si instalaste el plugin, ya estás conectado al servidor MCP de Aggrega. De lo contrario, conéctate al servidor MCP de Aggrega, que es el comando `aggrega mcp`, de la forma en que añades un servidor MCP, como `https://aggrega.ai/docs/ai-assistants/mcp-server/` lo describe para ti. Si necesitas reiniciar o recargar para cargar el plugin o el servidor, dime qué hacer.

4. Una vez conectado, llama a la herramienta `describe-capabilities` sin argumentos y resume lo que enumera.

**Mostrar el prompt completo**

- **La habilidad** — Le indica al asistente cómo funciona el ciclo de autoría y que tome cada respuesta sobre un esquema o un archivo del binario aggrega.

- **El servidor MCP** — aggrega mcp le da al asistente las herramientas de Aggrega: scaffold, validate, build y las demás.

[Qué cambia de un asistente a otro](https://aggrega.ai/docs/es/ai-assistants/set-up/)

### Cómo funciona

Tú describes la aplicación, Aggrega escribe los archivos y las herramientas que ya usas los despliegan. Aggrega nunca accede a un clúster en ejecución ni a una cuenta en la nube.

Aggregate describe tu aplicación

Release la configuración de un entorno

Manifest cómo se construye cada parte

aggrega build misma entrada, mismos archivos

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

archivos que revisas y que te pertenecen

Fuera de Aggrega

ArgoCD · Flux · Terraform despliegan lo que escribió

Aggrega se detiene en los archivos. Nunca accede a un clúster en ejecución ni a una cuenta en la nube; tus propias herramientas despliegan lo que escribió.

#### Describe la aplicación

Un **Aggregate** nombra sus **componentes** y cómo se conectan.

#### Elige el entorno

Una **Release** aporta la configuración de ese entorno.

#### Elige cómo se construye cada parte

Un **Manifest** asigna cada componente a una **Recipe** para tu plataforma, como un chart de Helm, un módulo de Terraform o un contenedor.

#### Ejecuta aggrega build

El comando escribe los archivos para cada plataforma: los **mismos archivos** para la misma entrada, siempre.

#### Despliega con tus herramientas

Lo que escribió el comando lo despliegan **ArgoCD**, **Flux** o **Terraform**.

### Qué puedes construir

Empieza con un ejemplo ejecutable o con los componentes del catálogo.

#### Agentes de IA y gateways

Agentes creados con LangGraph, CrewAI, LlamaIndex, Dify, n8n y otros, detrás de gateways de modelos con presupuestos de tokens, caché semántica, enmascaramiento de registros y un escudo contra la inyección de prompts.

[Un agente detrás de un gateway con un presupuesto de tokens](https://aggrega.ai/docs/es/language-reference/examples/envoy-ai-gateway-token-budget/)

#### Cargas de trabajo tradicionales

Bases de datos, cachés, brokers de mensajes y gestión de identidades, por ejemplo PostgreSQL, MariaDB, Redis, Kafka y Keycloak.

[Una base de datos PostgreSQL, desplegada de tres maneras](https://aggrega.ai/docs/es/language-reference/examples/postgres-three-realizations/)

#### Features

Capacidades que adjuntas por entorno sin tocar la aplicación, por ejemplo un escudo contra la inyección de prompts, el enmascaramiento de datos sensibles, ingress HTTPS, supervisión y copias de seguridad.

[Un gateway que revisa cada solicitud en busca de inyección de prompts](https://aggrega.ai/docs/es/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### Una aplicación, muchas plataformas

El mismo Aggregate se construye para Docker Compose en un equipo portátil y para Kubernetes en producción: cambiar de destino cambia un mapeo, no tu código.

[Un Aggregate, construido para Compose y Kubernetes](https://aggrega.ai/docs/es/language-reference/examples/mariadb-adminer/)

aggregate.yaml escrito una vez

En un portátil

release-compose.yaml

manifest-compose.yaml

aggrega build

docker-compose.yaml

En un clúster de Kubernetes

release-helm-synth.yaml

manifest-helm-synth.yaml

aggrega build

manifiestos de Kubernetes

Cada plataforma se construye a partir de su propia Release y su propio Manifest. El Aggregate, que describe tu aplicación, sigue siendo el mismo.

#### Gobernanza y políticas

Tus políticas se conectan al compilador y detienen una compilación que las incumple, indicando qué corregir.

[Una política, comprobada en cuatro destinos](https://aggrega.ai/docs/es/language-reference/examples/policy-render-verdict/)

aggrega build

tu política conectada al compilador

aprobada

archivos escritos listos para revisar y desplegar

rechazada

compilación detenida policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted

Una política puede detener una compilación e indicar qué corregir. Nunca cambia tus archivos para que la superen.

#### Compilaciones reproducibles

Misma entrada, misma salida, con cada dependencia fijada en un archivo de bloqueo.

[Construye un ejemplo y su archivo de bloqueo](https://aggrega.ai/docs/es/language-reference/examples/ai-agent-and-model-router/#building)

#### El catálogo de la biblioteca estándar

Components para agentes, modelos, gateways, almacenes de datos, mensajería, observabilidad, seguridad y almacenamiento, listos para usar en un Aggregate.

[Explora el catálogo](https://aggrega.ai/catalog/es/browse)

### Tu asistente, con Aggrega

Lo que gana un asistente que escribe tu código de infraestructura al trabajar a través de Aggrega.

- **Reproducible** — Misma entrada, mismos archivos, con cada dependencia fijada en un archivo de bloqueo.

- **Una sola descripción** — Una sola descripción de la aplicación, construida para cada plataforma en la que se ejecuta.

- **Políticas en tiempo de compilación** — Tus políticas se ejecutan en el compilador y detienen una compilación que las incumple.

- **Un catálogo firmado y versionado** — Lo que un asistente descarga del catálogo está versionado y firmado, y la descarga verifica cada firma.

- **Comprobado por el compilador** — El asistente valida y compila con el binario aggrega, y toma de él sus respuestas sobre esquemas y archivos.

### Destinos

Cada plataforma recibe los archivos que lee de forma nativa. Los agentes de IA se ejecutan en cualquier clúster de Kubernetes, y muchos también en Compose.

- **Kubernetes** — Manifiestos de Kubernetes, un archivo por recurso, para que ArgoCD o Flux los apliquen.

- **Helm** — Charts de Helm, renderizados en manifiestos de Kubernetes.

- **Compose** — Un archivo de Docker Compose, para ejecutar la aplicación en un equipo portátil.

- **Terraform** — Configuración para servicios gestionados en la nube. Aggrega nunca ejecuta Terraform.

- **CloudFormation** — Plantillas de stack para AWS. Aggrega nunca ejecuta CloudFormation.

[Qué escribe cada destino](https://aggrega.ai/docs/es/language-reference/providers/reference-matrix/)

### Importación

aggrega import lee un proyecto en uno de estos formatos y escribe borradores de archivos de Aggrega para que los revises y edites.

- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose

aggrega import

borradores de archivos Aggrega para que los revises y edites

Tu proyecto existente entra, salen borradores de archivos Aggrega. No se despliega nada; primero revisas los borradores.

[Cómo funciona la importación](https://aggrega.ai/docs/es/authoring/import/)

### Comienza

#### Inicio rápido

Instala Aggrega, construye un ejemplo ejecutable, ejecútalo en tu máquina y luego hazlo crecer paso a paso.

[Primeros pasos](https://aggrega.ai/docs/es/getting-started/)

#### Ejecuta un primer ejemplo

Cada ejemplo ejecutable es un espacio de trabajo completo que construyes con la CLI de aggrega.

[Explora los ejemplos](https://aggrega.ai/docs/es/language-reference/examples/)

#### Instalación

Un solo comando instala el binario aggrega para tu usuario, sin permisos de administrador.

[Instala el binario](https://aggrega.ai/docs/es/install/#install-the-binary)

### Código abierto

El compilador de Aggrega es de código abierto bajo Apache-2.0, y seguirá siéndolo: no habrá una edición cerrada del compilador, ni open-core. Todas las funcionalidades del compilador estarán disponibles en la versión de código abierto.

#### El compilador

El binario aggrega y su interfaz de línea de comandos.

[aggrega-ai/aggrega-cli en GitHub](https://github.com/aggrega-ai/aggrega-cli)

#### Visual Studio Code

Validación, navegación, información al pasar el cursor y autocompletado para el YAML de Aggrega, respaldados por el binario aggrega.

[La extensión en GitHub](https://github.com/aggrega-ai/aggrega-vscode-extension)
