Сейчас только ленивый не делает свой нодовый редактор.
Я решил помочь всем быть ещё ленивее и сделать вилку для макаронного монстра: открытый конструктор, в котором сам нодовый редактор собирается из готовых частей, а ноды перестают быть пленниками одной программы и превращаются в переносимые штуки. Ноду можно скачать, поставить себе, кинуть другому человеку, бросить в библиотеку, собрать из нескольких цепочку — а потом свернуть эту цепочку обратно в одну ноду.
Проект называется SnarkRoute. Рабочий публичный кусок сейчас живёт как BoojumRoute Lab — локальный блочный редактор маршрутов. А под ним лежит то, ради чего всё и затевалось: Open Route Protocol, переносимый формат для описания AI-, model- и API-воркфлоу.
Это вторая серия
Недавно я выкладывал тут «ИИ дал одиночке студию. Проблема в том, что студия арендована» — про то, что ИИ выдал одиночке целую производственную студию, но в аренду, и что спасёт нас не очередной маркетплейс для креаторов, а открытый протокол маршрутов между моделями: с provenance, авторством и экономикой, зашитыми в формат с самого начала. Был черновой route.yaml на салфетке и финальный вопрос в зал — «кто-нибудь вообще делает что-то похожее, покажите».
Часть комментариев тогда сводилась к простому: теория красивая, а код где. Возразить нечего, всё по делу. Поэтому я пошёл и начал прикручивать первый болт к настоящей машине. Эта статья — про болт.
Про ИИ сразу, чтобы потом не ловить вилы в комментах: да, часть кода я писал с активной помощью моделей, в репозитории даже лежит Codex-скилл для сборки нод (чтобы кто угодно мог сделать свои ноды) . Только это не тот жанр, где «нейросеточка собрала проект, восхищайтесь». Скорее наоборот — проект за пару дней наглядно показал, что стоит убрать протокол, тесты, схемы валидации и границы между слоями, и всё мгновенно превращается в кашу. Так что тут AGPL, vitest, схема протокола и декларативные манифесты вместо «скачали чужой JS, запустили, помолились».
Каждый AI-инструмент строит свой остров
Любой современный AI-инструмент рано или поздно отращивает себе нодовый редактор. ComfyUI, n8n, Weavy, внутренние пайплайны студий, самопальные обвязки вокруг Replicate, Fal, OpenRouter — по сути все решают одну задачу. Но дальше начинается беда: каждый редактор оказывается отдельным островом. Воркфлоу, собранный в одном месте, в другое не переезжает. Его трудно воспроизвести, трудно вскрыть и посмотреть, что внутри, а пользователь намертво прибит к интерфейсу вместо логики процесса. И вот сотни людей раз за разом изобретают одну и ту же коробочку с входами и выходами — и каждый заваривает её в свой несовместимый формат.
Это та самая дыра, на которую я тыкал пальцем в прошлый раз. Только теперь не тыкаю, а лезу её затыкать.
Переносим не ноду, а весь маршрут
Главная мысль та же, что я защищал и раньше: в центре не модель и не редактор, а маршрут.
Маршрут (route) — это читаемый документ воркфлоу. В нём ноды, связи, параметры, провенанс, экономика запуска и ссылки на ассеты. Чего в нём нет — так это провайдерских секретов и зашитых напрямую внешних файлов. Вот это и есть главный артефакт: то, что можно переслать, вскрыть, ремикснуть и запустить, и оно не рассыплется при переезде.
Под маршруты написан Open Route Protocol — тот самый салфеточный route.yaml, доросший до нормальной схемы. Канонический формат теперь .orp (есть ещё .orp.json и .orp.yaml для тех, кому удобнее, и человекочитаемый алиас .route). Внутри — инстансы нод, рёбра, параметры, метаданные провенанса и экономики, ссылки на ассеты через AssetRef. Поля author, license, provenance, economics, steps из старого черновика на месте, просто обросли валидацией и исполнителем.
Ноды при этом не пропадают, а становятся кирпичами: пакуются в .snarknode, тащатся в редактор перетаскиванием, складываются в библиотеку, собираются в составные блоки. Переносимость живёт на двух этажах — маршрут целиком как документ и отдельная нода как кирпич. И то, и другое реально берётся в руки.
Что внутри
SnarkRoute — это TypeScript-монорепо на pnpm. BoojumRoute Lab собран на Vite + React + React Flow, локальный сервер на Fastify, тесты на Vitest. И всё это local-first: ключи, запуски, ассеты и настройки по умолчанию остаются на твоей машине, а наружу маршрут лезет, только когда ты сам позвал внешнего провайдера.
Провайдеры тут не хозяева, а слои внутри маршрута. Replicate, Gemini, OpenRouter, Polza.ai (и кто там ещё придёт) подключаются через provider-neutral Model Gateway: нода зовёт зарегистрированный адаптер через гейтвей, а сам файл маршрута остаётся провайдер-агностичным и сырых секретов не хранит вообще. Гейтвей ещё умеет прикидывать стоимость заранее по кэшированным каталогам цен — но если прикинуть не получается, честно пишет Unknown, а не выдумывает, и за тебя «самого дешёвого» не выбирает.
Крутит всё это DAG-движок: топологическая сортировка, ловля циклов, шаблонные ссылки между нодами ({{prompt1.output.text}}), логи, результаты запусков. Запуски ложатся в data/runs/, рядом тикает локальный ledger (data/ledger/runs.jsonl) с провенансом и экономикой.
Экономика в ДНК, как и обещал
В прошлой статье я упёрся рогом: поля под автора, лицензию, атрибуцию, доли и провенанс надо закладывать в формат с первого дня — пусть нулевыми, опциональными, выключенными, — потому что потом их не добить без сломанной совместимости.
Так и сделал. Маршрут может нести авторов, контрибьюторов, доли выручки, подсказки по цене, валюту, заметки. Каждый запуск получает локальную сводку учёта — но с честным paymentExecuted: false. SnarkRoute v0.1 держит экономику как метаданные и локальный учёт, и не исполняет ни платежей, ни сеттлментов, ни — упаси — блокчейн-вызовов. Поля есть. Рубильник опущен. Та самая архитектурная трезвость, о которой был весь раздел.
Безопасность тут фича, а не дыра, которую я проглядел
Первое, что думает любой нормальный человек, услышав «переносимые ноды, которые можно слать друг другу»: ага, отличный способ сделать ещё один небезопасный npm, только для графов. Я думаю ровно то же самое, поэтому ответ закладывал с самого начала.
Никакого исполнения чужого произвольного JavaScript. Ноды сообщества — это декларативные манифесты с явными permissions, а не «скачали и запустили».
AssetRef вместо прямой загрузки. Маршрут не тянет файлы и URL сам. Он держит ссылку, а хост уже решает, что с ней делать: резолвить, кэшировать, валидировать по схеме, сверять хеш, встраивать, бандлить или просто заблокировать. Выглядит ссылка вот так:
{
"uri": "asset://local/text/prompt/image-generation/retro-futuristic-editor-joke",
"kind": "text/prompt",
"expectedHash": "sha256:...",
"version": "1.0.0"
}Секреты живут только на хосте и не уезжают ни с маршрутом, ни с бандлом.
Hash-пиннинг ругается, если ассет подменили, и помогает делать воспроизводимые маршруты.
Короче, переносимость тут не означает «доверься первому встречному пакету». Хост остаётся хозяином того, что по-настоящему исполняется и подгружается.
Что уже работает
BoojumRoute Lab — рабочий блочный редактор;
создание и запуск маршрутов;
схема Open Route Protocol v0.1: парсинг, валидация, YAML и JSON;
DAG-исполнитель с топосортом, ловлей циклов, логами, результатами;
установка .snarknode и drag-and-drop импорт нод;
плейсхолдеры на месте недостающих нод (маршрут не разваливается, если ноды нет);
библиотека промптов как первый пример Asset System (.prompt.md с YAML-фронтматтером);
встроенные ноды: текст, файлы, картинки, видео, шаблоны, дебаг-логи, превью, вывод;
provider-backed ноды, когда настроены локальные провайдеры;
импорт/экспорт .orp;
локальный ledger запусков.
Живой пример — апскейл картинки: input.image → Replicate Clarity Upscaler → preview.image → output.file. Replicate отдаёт ссылки, которые протухают, поэтому результат сразу качается локально в data/runs/<runId>/assets/.
Чего пока нет
Это все еще альфа, и многого тут нет, так что вот граница как есть:
нет аутентификации, облака, аккаунтов, маркетплейса, платежей;
AssetRef / AssetSource / AssetResolver недоделаны;
режимы экспорта linked / embedded / bundle пока висят в роадмапе;
абсолютные локальные пути у input-нод бьют по переносимости (осознанное MVP-ограничение, дальше переезд на AssetRef);
SnarkRoute Living Canvas — второй, более «творческий» шелл — пока экспериментальный, без запуска в один клик;
реальную стоимость провайдера часто не узнать до запуска.
Сразу оговорюсь
Я не собираюсь никого заменять и тем более «убивать ComfyUI». Фокус просто другой. ComfyUI — отличный граф под генерацию картинок, n8n — отличная автоматизация, а я делаю переносимый формат маршрута поверх моделей, API, ассетов, провенанса и провайдеров. По духу это то самое «не лепить центр там, где хватит протокола» из прошлой статьи: открытая спецификация, локальное исполнение, право форкнуть без потери совместимости. Не «убьём всех драконов», а «сделаем тележку, чтобы возить драконьи яйца». Скромнее и полезнее.
Зову
Прошлая статья кончалась вопросом в зал: кто делает что-то близкое. В этот раз вопрос обратный — вот моя реализация, ломайте.
Где все это ломается? Какие поля обязаны быть в манифесте ноды и в схеме маршрута? Как сделать permissions так, чтобы переносимость не стала дырой? И где проходит граница между «удобно» и «ну вот, снова небезопасный npm, только для графов»?
Особенно жду тех, кто живёт в ComfyUI и TouchDesigner, гоняет локальные модели или собирает воспроизводимые пайплайны: какими форматами вы уже пользуетесь и что заставило бы вас захотеть поделиться маршрутом.
Стек: TypeScript-монорепо, Vite + React + React Flow, Fastify, Vitest, local-first. Лицензии: код под AGPL-3.0-or-later, спецификация, документация и примеры — под CC BY-SA 4.0.
Код живёт тут: github.com/Snark-s/snarkroute
Если хочется не читать, а смотреть, как маршрут собирается и реально крутится, — на ютубе youtube.com/@SnarkRoute лежат демки (там же то самое видео с Clarity-апскейлом).
А в телеге t.me/snarkroutelab я выкладываю апдейты и торчу на связи. Нас там пока горстка, так что если хочется попасть в проект на стадии, когда тебя ещё слышно, — момент удачный.