ComfyUI Mixlab 插件 Whisper.available False 报错修复
ComfyUI Mixlab 插件出现 Whisper.available False 错误。原因是代码在初始化时强制扫描不存在的 models/whisper 目录导致异常。解决方案包括手动创建该目录,或修改 Whisper.py 源码增加自动创建目录逻辑。同时需确保模型文件夹内包含 config.json 文件(Faster-Whisper 格式),并正确放置模型文件至指定路径后重启验证。

ComfyUI Mixlab 插件出现 Whisper.available False 错误。原因是代码在初始化时强制扫描不存在的 models/whisper 目录导致异常。解决方案包括手动创建该目录,或修改 Whisper.py 源码增加自动创建目录逻辑。同时需确保模型文件夹内包含 config.json 文件(Faster-Whisper 格式),并正确放置模型文件至指定路径后重启验证。

在 ComfyUI 中安装 Mixlab Nodes 插件后,控制台显示其他节点正常,但 Whisper.available False。即使环境里安装了 openai-whisper 和 faster-whisper,问题依然可能存在。
Mixlab 的默认日志只提示 False,不显示原因。为了抓出真凶,我们需要修改插件的入口文件:
custom_nodes/comfyui-mixlab-nodes/__init__.pyexcept 块改为打印完整堆栈。# 修改前
except Exception as e: logging.info('Whisper.available False')
# 修改后 (增加 Traceback 打印)
except Exception as e:
import traceback
logging.info(f'Whisper.available False. Reason: {e}')
traceback.print_exc()
修改后重启,控制台显露真凶:
FileNotFoundError: [WinError 3] 系统找不到指定的路径。: '...\models\whisper'
排查发现,该问题并非依赖缺失,而是 nodes/Whisper.py 的代码健壮性不足:
models/whisper 文件夹。os.listdir() 会直接抛出异常导致模块加载失败。在你的 ComfyUI 的 models 目录下,手动新建文件夹:whisper。
打开 custom_nodes/comfyui-mixlab-nodes/nodes/Whisper.py,在 model_sizes 扫描逻辑前加入自动创建目录的判断。
# 确保目录存在,防止 os.listdir 报错抛出 WinError 3
if not os.path.exists(whisper_model_path):
os.makedirs(whisper_model_path)
# 此时再执行扫描逻辑,即使文件夹为空也只会返回空列表,不会导致加载失败
model_sizes = [
d for d in os.listdir(whisper_model_path)
if os.path.isdir(os.path.join(whisper_model_path, d))
and os.path.isfile(os.path.join(os.path.join(whisper_model_path, d), "config.json"))
]
由于代码检查 config.json,我们需要下载 Faster-Whisper 格式的模型(如 Systran/faster-whisper-tiny)。
下载地址:
工具:可以使用 hf-mirror 镜像下载。
存放:将模型文件(model.bin, config.json 等)放在 models/whisper/faster-whisper-tiny/ 下。
正确的文件结构应该是:
text
models/whisper/faster-whisper-tiny/
├── config.json
├── model.bin
├── tokenizer.json
├── vocabulary.txt
└── README.md (可选)
Mixlab 的这个节点通常支持以下两类模型:
常用的模型包括:
faster-whisper-tiny (体积小,速度极快)faster-whisper-base (平衡性好)faster-whisper-large-v3 (精度最高,中文识别强)刷新节点:放好之后,你可以在 ComfyUI 中添加 Load Whisper Model ♾Mixlab 节点,在下拉菜单里就能看到你刚放进去的文件夹名字了。
重启 ComfyUI 后查看控制台日志输出以验证修复:
可以看到控制台显示 Whisper.available 后面没有 False(或者显示了 True),就说明模块已经绕过了路径检查,成功加载到了 ComfyUI 中。
在开发 ComfyUI 插件或维护 Python 环境时:
__init__.py 打印 traceback 是定位插件加载问题的万能钥匙。os.listdir 前必做 os.path.exists 或 os.makedirs。
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online