Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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.

  • Avvio rapido

    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.

  • Impara Aggrega

    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:

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

Su Windows, in PowerShell:

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

Ciascuno 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:

  1. 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.
  2. 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 riservata component.aggrega.ai/type di 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.
  3. 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-transform del socket di governance per l’etichettatura dinamica della topologia e i suoi ruoli di verdetto per la valutazione dei confini di sicurezza architetturali.
  4. 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 uses tra 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.