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 её репозитория.