Aggrega
Що таке Aggrega
Aggrega — компілятор з відкритим кодом для архітектури доби ШІ. Опишіть компоненти застосунку та те, як вони з’єднані; Aggrega детерміновано перетворює їх на файли розгортання, які запускають цей застосунок.
- Використовуйте мови, які знаєте. Компілятор для мов, якими ви вже користуєтеся: на вході YAML; на виході чарти Helm, маніфести Kubernetes і файли Compose, Terraform або CloudFormation.
- Розробники описують, Ops реалізує. Розробники оголошують компоненти, їхні можливості й те, хто кого використовує; команда платформи вирішує, як і де працює кожен із них.
- Один застосунок, багато платформ. Той самий застосунок працює в Docker Compose на ноутбуці та в Kubernetes у продакшені: зміна цілі змінює відображення, а не ваш код.
- Відтворювано й кероване. Той самий вхід — той самий вихід, і кожну залежність закріплено в lockfile. Ваші політики підключаються до компілятора й зупиняють збірку, яка їх порушує, вказуючи, що виправити.
Aggrega італійською означає «збирає докупи»: назва говорить про те, що робить інструмент, який збирає частини застосунку в один опис.
-
Використання з вашим ШІ-асистентом
Вставте один промпт в асистента, який може виконувати команди: він установить Aggrega, додасть навичку Aggrega і під’єднається до MCP-сервера Aggrega, перепитуючи вас, перш ніж щось установлювати.
-
Встановіть Aggrega, запишіть робочий приклад у теку й запустіть його на своєму комп’ютері, а потім розвивайте його крок за кроком: ШІ-агент на локальній моделі або вебзастосунок із PostgreSQL.
-
Шлях документацією в порядку читання, від призначення Aggrega до довідника мови.
Встановлення
У Linux і macOS:
curl -fsSL https://aggrega.ai/install.sh | shУ Windows, у PowerShell:
irm https://aggrega.ai/install.ps1 | iexКожна з цих команд установлює бінарний файл aggrega для поточного користувача. Розділ Встановлення описує, що робить команда, Homebrew, Scoop, winget і завантаження вручну; розділ Підключення сервера MCP пояснює під’єднання ШІ-асистента. Розширення Aggrega для Visual Studio Code додає валідацію, навігацію, підказки під час наведення та автодоповнення для YAML Aggrega на основі бінарного файлу aggrega.
Документація
Документація для користувачів мови та компілятора Aggrega, написана англійською та перекладена всіма іншими мовами, які пропонує сайт. Вона складається з трьох частин.
- Архітектура — «чому» Aggrega. Бачення, позиціонування, ментальна модель, конвеєр компілятора на концептуальному рівні, корпоративне врядування, каталог, розширюваність, проєктні рішення. Під час першого читання опрацюйте пронумеровані розділи з 01 по 16 по порядку.
- Посібник з авторингу — «як сісти й почати писати» в Aggrega. Цикл авторингу, чотири ролі, що співпрацюють, відповідність kind ролям і те, як під’єднати ШІ-асистента через сервер Model Context Protocol. Почніть із розділу Написання файлів Aggrega; щоб ваш ШІ-асистент сам установив і налаштував Aggrega, вставте промпт із розділу Налаштування Aggrega з ШІ-асистентом.
- Довідник мови — «що» і «як використовувати» Aggrega. Почніть зі Стану мови, щоб дізнатися про поточний рівень готовності, а потім під час першого читання опрацюйте пронумеровані розділи з 01 по 09 по порядку. Ненумеровані підкаталоги (entities/, vocabulary/, templates/, providers/, plugins/, schema/, cli/, errors/, examples/) є довідковими каталогами — переходьте до конкретних елементів за потреби.
Про Aggrega
Компілятор Aggrega має відкритий код за ліцензією Apache-2.0 і таким залишиться: закритої редакції компілятора не буде, як і моделі open-core. Усі можливості компілятора будуть доступні у версії з відкритим кодом.
Екосистема спирається на чотири стовпи:
- Модель розділення (натхненна OAM): проєктна настанова, що відокремлює намір розробника (абстрактні «Що» і «Скільки») від фізичної реальності Platform Ops (фізичних «Як» і «Де»). Компілятор не нав’язує цього розділення: він приймає будь-який шаблон авторингу, що проходить валідацію за схемою.
- Семантична DSL & операційна онтологія: розробники відображають свою архітектуру за допомогою закритого набору універсальних хмарних примітивів (наприклад,
server,worker,stateful-server) на зарезервованій мітціcomponent.aggrega.ai/typeплатформи Aggrega. Увесь розширений контекст—як-от автономність агентів ШІ, генеративні можливості чи відповідність даних вимогам—накладається поверх за допомогою статичних міток Duck-Typing, а каталог, що класифікує компоненти за власною віссю, додає власний ключ мітки. - Програмовані політики & валідація: базовий компілятор на Go — без власної позиції. Корпоративне врядування повністю спирається на галузеві стандарти та підключуваний WebAssembly: JSON Schema 2020-12 (записана компактним скороченим записом у формі YAML або повним JSON Schema YAML) для валідації каталогу, роль
label-transformсокета врядування для динамічного тегування топології та його ролі вердикту для оцінювання архітектурних меж безпеки. - Компілятор AOT & передавання на виконання: сувора конвеєрна обробка компіляції перетворює DSL на граф проміжного представлення (IR), агностичний щодо можливостей. IR фіксує топологію компонентів і ребра
usesміж ними (хто кого використовує); компілятор передає цей граф сокету врядування WebAssembly (Wasm), щоб виявити транзитивні вразливості довіри, а потім виконує плагіни рендерингу Wasm, щоб згенерувати точні конфігурації проксі та запобіжників. Aggrega записує ці артефакти на диск і передає їх іншим інструментам, як-от конвеєрам CI/CD або оркестраторам середовища виконання, які їх розгортають.
Ліцензія
Документацію Aggrega випущено за ліцензією Apache License, Version 2.0; повний текст наведено у файлі LICENSE її репозиторію.