AQVEN в alpha: типизированный LLM-workflow проверяется до первого платного вызова

AQVEN хранит LLM-workflow типизированными файлами и проверяет связи вместе с симуляцией шагов до платного вызова модели: ключ и сеть для aqven check не нужны. Установка идёт через uv на Python 3.14, а Windows, лицензия source-available и отсутствие независимых замеров остаются границами alpha-версии.

AQVEN в alpha: типизированный LLM-workflow проверяется до первого платного вызова. Тематическая карточка Comrad404.

29 октября 2026 года в ленте Hacker News появилась ссылка на AQVEN — Python-фреймворк и локальную Studio для сборки многошаговых LLM-пайплайнов. По README проекта, workflow хранится типизированными файлами в репозитории, а команда aqven check проверяет его локально, до первого платного вызова модели. Проект в статусе alpha и распространяется как source-available, а не по открытой лицензии; запись в агрегаторе на момент сбора имела 1 балл и ни одного комментария, то есть внешнего обсуждения нет.

Схема: workflow хранится типизированными файлами в репозитории; валидирует каждое соединение и симулирует каждый флоу с заглушками вместо вызовов модели; Ключ модели и сеть для проверки не нужны.
Основные элементы, разобранные в статье.

Что именно проверяет aqven check

Workflow в AQVEN описан файлами: один задаёт flow, отдельный файл приходится на каждый шаг, промпты хранятся в Markdown, а типы, агенты и инструменты объявлены отдельно. Команда aqven check, по описанию автора, валидирует каждое соединение и симулирует каждый флоу с заглушками вместо вызовов модели. То есть проверяется согласованность схемы — сходятся ли объявленные связи между шагами, на месте ли указанные агенты и инструменты, — но не качество ответов.

Ключ модели и сеть для проверки не нужны. На только что созданном проекте команда выводит errors: 0, warnings: 0. Смысл промпта и поведение языковой модели симуляция не показывает: заглушка не обращается к модели, поэтому всё, что зависит от текста запроса и ответа, выясняется только реальным прогоном.

Установка: uv, Python 3.14 и готовый каркас

Нужен пакетный менеджер uv — он же скачивает интерпретатор. AQVEN работает на Python 3.14 и требует диапазон >=3.14,<3.15: движок рассчитан ровно на один минорный релиз, чтобы код шагов вёл себя одинаково на разных машинах.

uv tool install aqven
aqven new my_project --template minimal --provider openrouter

По описанию README, вторая команда создаёт проект, ставит окружение через uv sync и генерирует типизированные Python-модели. Она же готовит каталог под кодового агента: AGENTS.md, CLAUDE.md, .mcp.json с регистрацией MCP-сервера AQVEN и хуки Claude Code, которые запускают aqven check по ходу работы агента.

Проверка, реальный прогон и Studio

Проверка запускается из каталога проекта:

cd my_project
uv run aqven check my_project

Для настоящего прогона нужен ключ: .env.example копируется в .env, туда прописывается OPENROUTER_API_KEY. Расход идёт по тому ключу, который найдётся — в .env или в переменных окружения оболочки, — поэтому реальный запуск, по формулировке README, никогда не бесплатен.

Studio — локальное браузерное приложение в той же установке: оно показывает каждый прогон по шагам. Те же файлы правит кодовый агент — Claude Code, Codex или любой MCP-клиент — через MCP-сервер AQVEN, и он же запускает эксперименты, вердикты по которым считает сам AQVEN.

Где инструмент пока не работает

Ограничения существенные и собраны в одном месте. Проект в alpha, автор предупреждает об изменениях между релизами, а лицензия source-available. Платформы описаны неравномерно: на Linux полный набор CI-тестов идёт на ubuntu-latest при каждом изменении; macOS — основная платформа разработки, но полный набор тестов в CI на ней не запускается, проверены только установка из собранного wheel и офлайн-проверка; на Windows путь установки не доказан — смоук-воркфлоу собирает и ставит wheel и запускает aqven check, дальше ничего не тестировалось. Привязка к Python 3.14 жёсткая: 3.15 вышла в октябре 2026 года, поддержку обещают без даты. В README нет ни номера версии, ни даты релиза, ни бенчмарков; про деньги сказано только, что прогон не бесплатен. Дата 29 октября — дата появления записи в ленте, а не подтверждённый выход версии. Независимых замеров качества или стоимости источник не приводит: поведение aqven check остаётся описанием автора, пока код не запустит кто-то другой.