Nukomfy是一个适用于Foundry Nuke的 Python 插件,它可以将ComfyUI工作流程转换为可重用的 Nuke 小工具,将作业发送到网络上的 ComfyUI 机器,实时监控进度,并将生成的帧直接导入到您的合成中。

技术总监只需设置一次每个插件。艺术家们只需在合成器中直接调整必要的参数即可。无需切换上下文,也无需管理外部节点图。
工作原理
- 配置 Gizmo。将 ComfyUI 工作流转换为 Nuke Gizmo。在 ComfyUI 的应用程序构建器中公开其组件,选择哪些组件成为工作流创建器中的旋钮,并为 Gizmo 赋予其独特的样式。
- 选择一个工作流程。您的工作流程库包含您创建的所有工作流程,以及您的团队共享的任何工作流程。选择一个工作流程,它就会成为您电脑上的一个工具。
- 提交。连接印版,设置旋钮,然后将作业发送到 ComfyUI 机器。Nukomfy 会应用您预先配置的设置,自动处理文件格式和输出位置。对于单帧输出,批量计数功能允许您一次提交多个版本。
- 监控。渲染管理器会显示所有机器上的每个渲染作业,并带有实时进度条。您可以取消或删除自己的作业,如果您已配置管理员密码,也可以取消或删除任何人的作业。
- 重新导入。渲染完成后,将帧重新导入到合成中。Nukomfy 会保留每个作业的历史记录及其日志,即使在 ComfyUI 重启后也是如此,因此您可以随时重新导入帧。
要求
- Nuke 14.1 或更高版本。
- ComfyUI可通过 HTTP 访问(建议使用最新稳定版本)。
- 每个 ComfyUI 实例都安装了ComfyUI-Nukomfy-Suite
NukomfyRead。它提供了在 Nuke 和 ComfyUI 之间传输帧的节点NukomfyWrite,并解锁了重启、机器可用性控制和艺术家队列管理等管理功能。 - 共享文件夹:跨机器使用的文件夹必须可从所有机器访问。如果您的机器运行不同的操作系统,并且每台机器通过不同的路径访问这些文件夹,Nuke 的路径替换规则可以在它们之间进行转换。
- websocket-client(可选):启用渲染管理器中的实时进度条。如果没有启用,进度条仍会以阴影条的形式显示,并在每次刷新时更新。
已在Windows 和 Linux 系统上测试(macOS 系统尚未测试)。
安装
从发布页面下载并解压最新版本。
将
Nukomfy文件夹复制到您的~/.nuke/目录中。在你的文件中添加以下行
~/.nuke/menu.py:
import Nukomfy重启Nuke。Nukomfy菜单将出现在菜单栏中。
在每个 ComfyUI 实例上,安装ComfyUI-Nukomfy-Suite(有关安装说明,请参阅存储库)。
选修的:websocket-client
要启用实时进度条,websocket-client必须能够从 Nuke 运行的 Python 环境中导入该模块。它完全由 Python 编写,需要 Python 3.9 或更高版本,而所有受支持的 Nuke 版本都自带这些版本。
选项 A:安装到 Nuke 的 Python 环境中(推荐)
打开终端(Windows 系统下为命令提示符),运行命令,并将 `<version>` 替换<version>为您安装的 Nuke 版本:
# Linux / macOS/usr/local/Nuke<version>/python3 -m pip install websocket-client# Windows (run the prompt as administrator)"C:\Program Files\Nuke<version>\python.exe" -m pip install websocket-client
方案 B:将源代码打包到 Nuke 的插件路径中
如果您无法写入 Nuke 的 Python 代码,请将该软件包添加到 Nuke 的插件路径中:
下载最新版本的源代码(zip)(例如)。
v1.9.0解压并保留整个
websocket-client-1.9.0/文件夹(可导入的websocket/包就在里面)。将该文件夹添加到插件路径中
~/.nuke/init.py:
nuke.pluginAddPath('/path/to/websocket-client-1.9.0')当前局限性
Nukomfy官方仅支持图像序列作为输入和输出。其他数据类型,例如3D模型,目前尚未正式支持,但未来可能会通过套件中的新节点添加此功能。
漏洞与问题
Nukomfy目前处于早期开发阶段,可能存在漏洞。
发现 bug 或有功能建议?请在 GitHub 上提交 issue。请提供相关的技术细节和重现步骤。
相关项目
Nukomfy 并不是将 ComfyUI 引入 Nuke 的唯一方法,这里还有另一个值得一看的优秀项目:
- vinavfx/ComfyUI-for-Nuke (GPL-3.0) 是一个 API,允许你在 Nuke 中使用 ComfyUI 节点,且仅需 ComfyUI 服务器。Nukomfy 将一个完整的 ComfyUI 工作流封装成一个单独的 gizmo,而 ComfyUI-for-Nuke 则允许你在 Nuke 内部构建工作流。
执照
Nukomfy 采用 Apache License 2.0 许可。有关完整文本,请参阅LICENSE文件。
https://github.com/francescolorussi/Nukomfy
夜雨聆风