Published references, source identities and connected reading.
Have the exact error text? Paste it into Troubleshoot to find matching articles →
Log keyword: No module named 'hydra'
Hydra's common distribution name differs from its import name. A missing module and a missing configuration require separate repairs.
Log keyword: File name too long
An extraction, Git checkout or node build can fail because of one long path. Identify the failing tool before changing system policy or relocating an existing Python environment.
Log keyword: Dependency cycle detected
A normal data-dependency loop prevents a valid execution order. This is different from a supported loop/control-flow node with explicitly defined semantics.
Log keyword: Custom validation failed for node
A custom validator can return a rejection or raise an exception; ComfyUI records these as different errors. Read the specific node error before changing inputs or code.
Log keyword: invalid_input_type
A failed conversion and a value outside the current node’s bounds need different checks. Inspect the submitted value before changing node code or clipping numbers.
Log keyword: No module named scipy
Keep the precise import and operation errors instead of treating every scientific-library failure as an install issue.
Log keyword: Input contains (near) NaN/+-Inf
A codec rejecting nonfinite samples is not necessarily missing. Follow the audio entering it back through processing and decoding.
Log keyword: No module named av
Check PyAV, its linked libraries and an external FFmpeg executable as separate dependencies.
Log keyword: sensevoice-onnx
A historical setuptools constraint is not a reason to downgrade the whole environment. Establish the installed release and whether the error concerns building or runtime dependencies.
Log keyword: torchscale
Two nodes can require different timm versions. Map the consumers and their supported ranges before deciding whether one environment can serve both.
Log keyword: mediapipe
Installation can fail during resolution, or a completed installation can fail while loading an extension. Read the actual MediaPipe distribution rather than applying a historical constraint to every release.
Log keyword: Descriptors cannot be created directly
Older generated Python message code can conflict with its runtime. Locate the package carrying that code before changing every Protobuf consumer in the environment.
Log keyword: No module named 'dlib'
A face-processing node may have no usable Python binding or may have failed while building native code. Do not assemble an environment from unidentified DLLs or wheels.
Log keyword: No module named 'flash_attn'
A missing import or failed wheel build is not a reason to replace Torch immediately. Establish which FlashAttention implementation the node needs and whether your platform can provide it.
Log keyword: No module named segment_anything
Identify the implementation required by the node before replacing segmentation packages or checkpoints.
Log keyword: No module named mmcv
Distinguish full and lite distributions, source-build failures and runtime extension loading.
Log keyword: No module named cv2
Identify the installed OpenCV flavor before investigating missing modules or native-library loading.
Log keyword: No module named onnxruntime
Separate package discovery, runtime providers and the session that actually executes your model.
Log keyword: qwen-tts
Separate the node wrapper's requirements from those of the Qwen TTS distribution. A precise project pin is not a recommended shared version for every model.
Log keyword: No module named sqlalchemy
Separate missing libraries, database access and migration state without deleting the database.
Log keyword: Windows protected your PC
First establish which security feature blocked which file. A familiar filename is not proof that a download is the publisher's original release.
Log keyword: Bad linked input
An inputs list may be interpreted as a link rather than a literal array. Inspect serialization before assuming every JSON list will reach a node unchanged.
Log keyword: Return type mismatch between linked nodes
IMAGE, LATENT, MODEL and CONDITIONING have different roles. A drawable connection or similar socket color is not sufficient evidence of a valid interface.
Log keyword: No module named kornia
Distinguish a missing base package from an optional feature dependency before changing Torch.