Aggrega
Cos’è Aggrega
Aggrega è un compilatore open source per l’architettura dell’era dell’IA. Descrivi i componenti di un’applicazione e il modo in cui si collegano; Aggrega li trasforma, in modo deterministico, nei file di deployment che la eseguono.
- Usa i linguaggi che conosci. Un compilatore per i linguaggi che usi già: in ingresso YAML; in uscita chart Helm, manifest Kubernetes e file Compose, Terraform o CloudFormation.
- Gli sviluppatori descrivono, gli Ops implementano. Gli sviluppatori dichiarano i componenti, le loro funzionalità e chi usa chi; il team di piattaforma decide come e dove viene eseguito ciascuno.
- Un’applicazione, molte piattaforme. La stessa applicazione gira su Docker Compose su un laptop e su Kubernetes in produzione: cambiare destinazione cambia una mappatura, non il tuo codice.
- Riproducibile e governato. Stesso input, stesso output, con ogni dipendenza fissata in un lockfile. Le tue policy si collegano al compilatore e fermano una build che le viola, indicando cosa correggere.
In italiano, Aggrega vuol dire «mette insieme»: il nome dice ciò che fa lo strumento, che riunisce le parti di un’applicazione in un’unica descrizione.
-
Usalo con il tuo assistente AI
Incolla un unico prompt in un assistente in grado di eseguire comandi: installa Aggrega, aggiunge la skill di Aggrega e si collega al server MCP di Aggrega, chiedendoti conferma prima di installare qualsiasi cosa.
-
Installa Aggrega, scrivi un esempio eseguibile in una cartella ed eseguilo sulla tua macchina, poi fallo crescere un passo alla volta: un agente AI su un modello locale, oppure un’applicazione web con PostgreSQL.
-
Un percorso attraverso la documentazione in ordine di lettura, da ciò a cui serve Aggrega fino al riferimento del linguaggio.
Installazione
Su Linux e macOS:
curl -fsSL https://aggrega.ai/install.sh | shSu Windows, in PowerShell:
irm https://aggrega.ai/install.ps1 | iexCiascuno dei due comandi installa il binario aggrega per l’utente corrente. Installazione spiega cosa fa il comando, Homebrew, Scoop, winget e il download manuale; Collegare il server MCP collega un assistente AI. L’estensione Aggrega per Visual Studio Code porta convalida, navigazione, hover e completamento nello YAML di Aggrega, appoggiandosi al binario aggrega.
La documentazione
Documentazione rivolta agli utenti del linguaggio e del compilatore Aggrega, scritta in inglese e tradotta in tutte le altre lingue offerte dal sito. È composta da tre parti.
- Architettura — il «perché» di Aggrega. Visione, posizionamento, modello mentale, pipeline del compilatore a livello concettuale, governance aziendale, catalogo, estensibilità, scelte di progettazione. Per una prima lettura, segui in ordine i capitoli numerati da 01 a 16.
- Guida alla scrittura — il «come mettersi a scrivere» di Aggrega. Il ciclo di scrittura, i quattro ruoli che collaborano, la mappa dai tipi di entità ai ruoli e come collegare un assistente AI tramite il server Model Context Protocol. Inizia da Scrivere file Aggrega; per far installare e configurare Aggrega dal tuo assistente AI, incolla il prompt in Configurare Aggrega con il tuo assistente AI.
- Riferimento del linguaggio — il «cosa» e il «come usarlo» di Aggrega. Inizia da Stato del linguaggio per lo stato attuale di maturità, poi, per una prima lettura, segui in ordine i capitoli numerati da 01 a 09. Le sottodirectory non numerate (entities/, vocabulary/, templates/, providers/, plugins/, schema/, cli/, errors/, examples/) sono cataloghi di riferimento — passa direttamente alle singole voci secondo necessità.
Informazioni su Aggrega
Il compilatore Aggrega è open source con licenza Apache-2.0, e resterà tale: non ci sarà alcuna edizione chiusa del compilatore, nessun open-core. Tutte le funzionalità del compilatore saranno disponibili nella versione open source.
L’ecosistema si fonda su quattro pilastri:
- Il modello di separazione (ispirato a OAM): indicazioni di progettazione che separano l’intento dello sviluppatore (il «Cosa» e il «Quanto» astratti) dalla realtà fisica delle Platform Ops (il «Come» e il «Dove» fisici). Il compilatore non impone questa separazione: accetta qualsiasi schema di scrittura che superi la validazione dello schema.
- Il DSL semantico & l’ontologia operativa: gli sviluppatori mappano la propria architettura usando un insieme chiuso di primitive cloud universali (ad esempio
server,worker,stateful-server) sull’etichetta riservatacomponent.aggrega.ai/typedi Aggrega. Tutto il contesto avanzato—come l’autonomia degli agenti di IA, le capacità generative o la conformità dei dati—viene stratificato sopra tramite etichette statiche di Duck-Typing, e un catalogo che classifica i componenti su un asse proprio aggiunge una chiave di etichetta propria. - Policy programmabili & validazione: il compilatore Go di base è privo di opinioni. La governance aziendale è guidata interamente da standard di settore e da WebAssembly collegabile: JSON Schema 2020-12 (scritto tramite una notazione abbreviata compatta in forma di YAML o in JSON Schema YAML completo) per la validazione del catalogo, il ruolo
label-transformdel socket di governance per l’etichettatura dinamica della topologia e i suoi ruoli di verdetto per la valutazione dei confini di sicurezza architetturali. - Il compilatore AOT & il passaggio all’esecuzione: una pipeline di compilazione rigorosa traduce il DSL in un grafo di rappresentazione intermedia (IR) agnostico rispetto alle capacità. L’IR cattura la topologia dei componenti e gli archi
usestra di essi (chi usa chi); il compilatore passa questo grafo al socket di governance WebAssembly (Wasm) per rilevare vulnerabilità di fiducia transitive, quindi esegue i plugin di rendering Wasm per generare le configurazioni precise di proxy e guardrail. Aggrega scrive questi artefatti su disco e li consegna ad altri strumenti, come le pipeline CI/CD o gli orchestratori di runtime, che ne eseguono il deployment.
Licenza
La documentazione di Aggrega è rilasciata sotto la Apache License, Version 2.0; il testo completo si trova nel file LICENSE del suo repository.