ComfyUI Nodes v3: Новая эра

Команда ComfyUI представила инициативу Nodes v3 — третью ревизию спецификации нод, направленную на решение ключевых проблем в экосистеме кастомных расширений. Вот основные нововведения и цели проекта:

 

1. Повышение стабильности

• Вводится публичный API для кастомных нод с подробной документацией и гарантиями обратной совместимости. Это позволит разработчикам не бояться, что обновления ComfyUI сломают их расширения.

• В долгосрочной перспективе все кастомные ноды будут использовать только публичный API, что упростит поддержку и развитие платформы.

 

2. Решение проблем с зависимостями

• Каждый пакет кастомных нод, использующий публичный API, сможет запускаться в отдельном процессе Python. Это позволит изолировать зависимости и избежать конфликтов между библиотеками разных расширений.

• Даже частичная изоляция уменьшит вероятность "поломки" ComfyUI при установке несовместимых нод1.

 

3. Динамические входы/выходы и улучшенные виджеты

• Новый объектно-ориентированный подход к описанию нод: все параметры (входы, выходы, виджеты) теперь объявляются явно внутри одного метода DEFINE_SCHEMA.

• Это делает структуру ноды более прозрачной и облегчает работу с динамическими параметрами и пользовательскими виджетами.

• Классы нод становятся статичными, что упрощает переносимость кода между разными средами (например, при распределённом или параллельном исполнении).

 

 

 

 

4. Упрощённое управление моделями

• Улучшается система поиска, загрузки и размещения моделей, что особенно актуально при работе с большими файлами и множеством кастомных нод.

 

5. Поддержка будущих возможностей

• Nodes v3 закладывают фундамент для:

  • Распределённого исполнения пайплайнов на нескольких машинах.

  • Параллельного выполнения нод на одном устройстве.

 

6. Версионирование и обратная совместимость

• API для кастомных нод будет версионироваться. Разработчики смогут указывать конкретную версию API, и их расширения будут продолжать работать даже после появления новых функций или изменений в ComfyUI.

• Для каждой стабильной версии создаётся адаптер, поддерживающий старые сигнатуры функций.

 

7. Асинхронность и параллелизм

• Новый API использует async-функции, что необходимо для поддержки параллельного и распределённого выполнения. Для большинства разработчиков переход будет простым: достаточно заменить def на async def и добавить await при вызове асинхронных функций.

 

Обратная связь

• Разработчики кастомных нод могут обсуждать инициативу и предлагать улучшения на официальном Discord ComfyUI. Для участников Comfy Registry открыт отдельный закрытый канал для прямой связи с командой1.

 

Заключение
Nodes v3 — это шаг к более надёжной, гибкой и масштабируемой архитектуре ComfyUI. Новая спецификация делает разработку кастомных нод проще и безопаснее, а также открывает путь к будущим возможностям платформы.