知仓学习社知仓学习社
comfyui_controlnet_aux 导入失败：No module named 'timm' / 全站资源搜索
搜索 更新 2026-10-02
报错 103 热门自定义节点/工作流专有报错 有来源可查

comfyui_controlnet_aux 导入失败：No module named 'timm'

报错原文（原样） 
No module named 'timm'
检索关键词 No module named 'timm'、controlnet_aux、comfyui_controlnet_aux、Unsupported Nodes、预处理器不显示、MediaPipe
先看这一句 升级 ComfyUI 或重装节点后，ControlNet Aux 的全部预处理器节点（Canny、Depth、OpenPose、Lineart 等）从节点列表里消失，命令行报 No module named 'timm' 或提示 Unsupported Nodes。
适用版本 全版本通用；ComfyUI 主程序大版本升级后尤其容易触发依赖被覆盖 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、全部主流环境

现象与触发场景

常见触发场景：

  • ComfyUI 主程序升级后，timm 被主程序依赖变更牵动而版本冲突或被卸载
  • 手动克隆了 comfyui_controlnet_aux 但没装 requirements
  • 同一个环境里同时装了多个依赖不同 timm 版本的节点包

根因

  • comfyui_controlnet_aux 的预处理器大量依赖 timm（PyTorch Image Models）与 huggingface_hub，缺失时节点包在 import 阶段整体失败，注册不到任何节点，表现为「节点不见了」而不是报错对话框
  • 部分预处理器（如 MediaPipe 人脸/手部相关）另外依赖 mediapipe，未装时该部分节点同样缺席
  • timm 与 transformers/torch 版本不匹配时不会报 ModuleNotFoundError，而是 import 时报符号错误，容易被误判成别的问题

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 用便携版内置 Python 装 timm 与节点 requirements
    仍然必须用便携版解释器。先装 requirements.txt（会一并带上 huggingface_hub 等），再单独补 timm。装完完全重启 ComfyUI。
    cd ComfyUI\custom_nodes\comfyui_controlnet_aux
    ..\..\python_embeded\python.exe -m pip install -r requirements.txt
    ..\..\python_embeded\python.exe -m pip install timm
  2. 需要 MediaPipe 系预处理器时补装 mediapipe
    用到 MediaPipe 相关的预处理器（人脸关键点、手部等）时还需要 mediapipe。它对新版 Python 支持滞后，如果装不上，先确认你的便携版 Python 版本；装不上就只用不需要 MediaPipe 的预处理器（Canny/Depth/OpenPose 等）继续工作。
    ..\..\python_embeded\python.exe -m pip install mediapipe
  3. 处理版本冲突：先在便携版里看已装版本再决定升降级
    如果 timm 已经装过但仍报错，多半是版本与 torch/transformers 冲突。先在便携版环境里列出 timm、torch、transformers 的版本，再按节点仓库 README 的 requirements 对齐版本；不要盲目 pip install -U 全部升级，那会把主程序依赖一起顶掉。
    ..\..\python_embeded\python.exe -m pip list
    ..\..\python_embeded\python.exe -c "import timm; print(timm.__version__)"

验证是否修好

重启后节点列表里能搜到 ControlNet Aux 的预处理器节点（如 Canny、Depth Anything、OpenPose），启动日志中没有该节点包的导入失败记录。

补充说明

error_text 取自 Fannovel16/comfyui_controlnet_aux issue #20 标题原文。另有 issue #597 标题为 '"Unsupported Nodes" after ComfyUI update'，是同一类「节点不显示」现象的真实记录。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [230] （节点仓库 issue）　No module named 'timm'　https://github.com/Fannovel16/comfyui_controlnet_aux/issues/20
  2. [231] （节点仓库 issue）　"Unsupported Nodes" after ComfyUI update　https://github.com/Fannovel16/comfyui_controlnet_aux/issues/597
  3. [232] （节点仓库 issue）　comfyorg/comfyui-controlnet-aux　https://github.com/comfyorg/comfyui-controlnet-aux

本条报错提到的节点仓库

下面这些节点仓库的名字出现在本条报错的正文里。这里只说「名字出现过」，没有断定问题就是它引起的； 点进去可以看这个包的用途、适配模型与下载量。

Fannovel16/comfyui_controlnet_aux 节点库

这条报错要用到的东西

按本条报错所属的类别（热门自定义节点/工作流专有报错）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

常用节点速查包常用节点参数小抄 / 常见连法示意图 待挂载
节点库找到对应节点仓库，看它的适配模型 板块 工作流看官方模板里这条工作流本来是怎么连的 板块

同一类别的其他条目

【100】打开别人的工作流，节点全变红，提示节点缺少 class_type 属性 有来源 【101】ComfyUI-Manager 连不上 Comfy Registry，刷新缓存失败 含未核实 【102】ComfyUI-Impact-Pack 导入失败：No module named 'ultralytics'（缺少检测模型依赖） 有来源 【104】WanVideoWrapper：No module named 'sageattention'（SageAttention 未安装或装错环境） 含未核实 【105】VideoHelperSuite：ffmpeg is required for video outputs and could not be found 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库