ComfyUI-Impact-Pack 导入失败：No module named 'ultralytics'（缺少检测模型依赖）

IMPORT FAILED - ModuleNotFoundError: No module named 'ultralytics'

现象与触发场景

常见触发场景：

• 手动 git clone 了 Impact-Pack 但没装它自己的 subpack 依赖
• 用 Manager 装 Impact-Pack 时依赖安装阶段失败/被中断
• 换了机器迁移 custom_nodes 目录，只复制了代码没复制环境

根因

• Impact-Pack 的检测器（bbox/segm detector）依赖 ultralytics 包，它不在 ComfyUI 主程序依赖里，节点包自己的 requirements 没装就会在 import 阶段直接失败，导致整包节点全部不注册
• Impact-Pack 还有一层 subpack（Impact-Subpack）与子模块依赖，只装了主包不装 subpack 时同样报 IMPORT FAILED
• 管理系统把 ultralytics 装到了系统 Python 或别的虚拟环境，而 ComfyUI 用的是便携版内置解释器，运行时仍然找不到

解决步骤

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

1. 用便携版内置 Python 装 ultralytics 及其依赖
   关键点是必须使用 ComfyUI 便携版自带的解释器。Windows 便携版的解释器就在 ComfyUI 根目录下的 python_embeded\python.exe；如果你当前目录在 custom_nodes 里，用相对路径 ..\..\python_embeded\python.exe。绝对不要直接敲 pip install，那会装到系统 Python 上，ComfyUI 依然报同样的错。
   cd ComfyUI\custom_nodes\ComfyUI-Impact-Pack
   ..\..\python_embeded\python.exe -m pip install -r requirements.txt
   ..\..\python_embeded\python.exe -m pip install ultralytics
2. 补装 Impact-Subpack（子包）
   Impact-Pack 的部分功能拆分在 ltdrdata/ComfyUI-Impact-Subpack 仓库里。Manager 安装时通常会一起带上，手动安装时必须单独克隆并装依赖，否则仍然 IMPORT FAILED。克隆后同样用便携版解释器装它的 requirements。
   cd ComfyUI\custom_nodes
   git clone https://github.com/ltdrdata/ComfyUI-Impact-Subpack.git
   ..\..\python_embeded\python.exe -m pip install -r ComfyUI-Impact-Subpack\requirements.txt
3. 下载 bbox/segm 检测模型并确认目录被 ComfyUI 识别
   ultralytics 只是运行库，检测器还需要模型文件（bbox 与 segm 各一套），默认放在 ComfyUI/models/ultralytics/bbox 与 .../ultralytics/segm。若在云环境或自定义 extra_model_paths.yaml，必须把 models/ultralytics_bbox、models/ultralytics_segm、models/sams 一起加进路径映射，否则模型落在临时层、重启即丢（社区 issue 已记录该坑）。
4. 重启并逐个确认节点是否注册成功
   依赖装完后必须完全关闭 ComfyUI 进程再启动（不是刷新浏览器）。启动日志里不应再有 Impact-Pack 的 IMPORT FAILED；在节点搜索框输入 FaceDetailer 应能搜到并拖到画布上。

验证是否修好

补充说明

error_text 取自 ltdrdata/ComfyUI-Impact-Pack issue #793 标题原文（标题即 'IMPORT FAILED - ModuleNotFoundError: No module named \'ultralytics\''）。

来源

1. [227] （节点仓库 issue）　IMPORT FAILED - ModuleNotFoundError: No module named 'ultralytics'　https://github.com/ltdrdata/ComfyUI-Impact-Pack/issues/793
2. [228] （节点仓库 issue）　ComfyUI-Impact-Pack: (IMPORT FAILED) Subpack　https://github.com/ltdrdata/ComfyUI-Impact-Pack/issues/689
3. [229] （社区）　RunPod image: extra_model_paths.yaml omits ultralytics_bbox/ultralytic　https://github.com/artokun/comfyui-mcp/issues/2302

本条报错提到的节点仓库

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

这条报错要用到的东西

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

同一类别的其他条目

返回报错库