[ERROR] Node `NunchakuFluxDiTLoader` import failed: – Nunchaku is ENTIRELY BROKEN

快速结论：该报错发生在 Krita AI Diffusion 插件尝试加载 Nunchaku 依赖时，Nunchaku 本身在当前环境中损坏或无法导入。优先排查 Python 版本是否为 ComfyUI 不支持的 3.13，并确认 Nunchaku 并非必须安装的节点。

问题场景

用户在使用 Krita AI Diffusion 插件（依赖于 ComfyUI）时，启动或加载 ComfyUI 工作流过程中触发了该报错。报错指向 NunchakuFluxDiTLoader 节点，该节点为 Nunchaku 项目提供 Flux 模型支持，但在用户环境中完全损毁。

报错原文

[ERROR] Node `NunchakuFluxDiTLoader` import failed: - Nunchaku is ENTIRELY BROKEN

原因分析

可能原因：用户使用了 ComfyUI 不支持的 Python 3.13 版本。Nunchaku 项目本身维护状态不佳，在 Python 3.13 下可能会彻底损坏或无法编译。此外，Nunchaku 是一个可选依赖，并非 Krita AI Diffusion 插件的强制组件，用户若手动安装或捆绑了损坏版本，会导致此报错。

环境排查

操作系统：Windows / Linux / macOS
ComfyUI 安装类型：便携版（.exe 文件）、自定义管理（自托管）、由本插件管理
Python 版本：确认是否使用 Python 3.13（ComfyUI 正式支持 Python 3.12）
Nunchaku 安装状态：检查 ComfyUI 的 custom_nodes 目录下是否有 Nunchaku 文件夹

解决步骤

将 ComfyUI 的 Python 环境降级或重装到 Python 3.12（根据官方文档要求）。便携版用户建议重新下载官方 Python 3.12 版本的 ComfyUI 包。
如果不需要 Nunchaku 节点：直接在 ComfyUI 的 custom_nodes 目录中删除或重命名 Nunchaku 文件夹，避免插件自动加载。
如果要保留 Nunchaku：在 Python 3.12 环境下，按照 Nunchaku 项目提供的安装说明重新编译安装（注意检查是否支持当前 CUDA 版本）。
重启 ComfyUI 和 Krita AI Diffusion 插件，确认报错不再出现。

验证方法

启动 ComfyUI，观察控制台是否仍输出 Nunchaku 相关错误；在 Krita AI Diffusion 插件中加载工作流时，确认不再弹出 NunchakuFluxDiTLoader 的导入失败提示。

参考来源

Acly/krita-ai-diffusion #2522

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

[ERROR] Node `NunchakuFluxDiTLoader` import failed: – Nunchaku is ENTIRELY BROKEN