Dependencies

What a shared workflow may need

A workflow file stores connected steps and settings. It does not include every file or extra node used by its creator. If a shared workflow will not run, check for these requirements first:

Input files: Images, video, or audio the workflow expects you to provide.
Local models: Model files that must be downloaded and selected.
Custom nodes: Extra node packages that are not installed in your ComfyUI.
Account and credits: Requirements for hosted Partner Nodes or Comfy Cloud nodes.

Start with Fix a workflow that will not run to identify the warning. The rest of this page explains these requirements and the Python packages needed by custom nodes. Most users do not need to manage Python packages directly.

Assets

An AI model is an example of an asset. In media production, an asset is some media file that supplies input data. For example, a video editing program operates on movie files stored on disk. The editing program’s project file holds links to these movie file assets, allowing non-destructive editing that doesn’t alter the original movie files. ComfyUI works the same way. A workflow can only run if all of the required assets are found and loaded. Generative AI models, images, movies, and sounds are some examples of assets that a workflow might depend upon. These are therefore known as dependent assets or asset dependencies.

Custom Nodes

Custom nodes are an important component of ComfyUI that extend its functionality. They are created by the community and can be installed to add new capabilities to your workflows.

Python Dependencies

ComfyUI is a Python-based project. We build a standalone Python environment to run ComfyUI, and all related dependencies are installed in this isolated Python environment.

ComfyUI Dependencies

You can view ComfyUI’s current dependencies in the requirements.txt file:

comfyui-frontend-package==1.49.6
comfyui-workflow-templates==0.11.48
comfyui-embedded-docs==0.5.10
torch
torchsde
torchvision
torchaudio
numpy>=1.25.0
einops
transformers>=4.50.3
tokenizers>=0.13.3
sentencepiece
safetensors>=0.4.2
aiohttp>=3.11.8
yarl>=1.18.0
pyyaml
Pillow
scipy
tqdm
psutil
alembic
SQLAlchemy>=2.0.0
filelock
av>=17.0.0
comfy-kitchen==0.2.31
comfy-aimdo==0.4.15
requests
simpleeval>=1.0.0
blake3

#non essential dependencies:
kornia>=0.7.1
spandrel
pydantic~=2.0
pydantic-settings~=2.0
PyOpenGL>=3.1.8
comfy-angle

As ComfyUI evolves, we may adjust dependencies accordingly, such as adding new dependencies or removing ones that are no longer needed. So if you use Git to update ComfyUI, you need to run the following command in the corresponding environment after pulling the latest updates:

pip install -r requirements.txt

This ensures that ComfyUI’s dependencies are up to date for proper operation. You can also modify specific package dependency versions to upgrade or downgrade certain dependencies. Additionally, ComfyUI’s frontend ComfyUI_frontend is currently maintained as a separate project. We update the comfyui-frontend-package dependency version after the corresponding version stabilizes. If you need to switch to a different frontend version, you can check the version information here.

Custom Node Dependencies

Thanks to the efforts of many authors in the ComfyUI community, we can extend ComfyUI’s functionality by using different custom nodes, enabling impressive creativity. Typically, each custom node has its own dependencies and a separate requirements.txt file. If you use ComfyUI Manager to install custom nodes, ComfyUI Manager will usually automatically install the corresponding dependencies. There are also cases where you need to install dependencies manually. Currently, all custom nodes are installed in the ComfyUI/custom_nodes directory. You need to navigate to the corresponding plugin directory in your ComfyUI Python environment and run pip install -r requirements.txt to install the dependencies. If you’re using the Windows Portable version, you can use the following command in the ComfyUI_windows_portable directory:

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\<custom_node_name>\requirements.txt

to install the dependencies for the corresponding node.

Dependency Conflicts

Dependency conflicts are a common issue when using ComfyUI. You might find that after installing or updating a custom node, previously installed custom nodes can no longer be found in ComfyUI’s node library, or error pop-ups appear. One possible reason is dependency conflicts. There can be many reasons for dependency conflicts, such as:

Custom node version locking

Some plugins may fix the exact version of a dependency library (e.g., open_clip_torch==2.26.1), while other plugins may require a higher version (e.g., open_clip_torch>=2.29.0), making it impossible to satisfy both version requirements simultaneously. Solution: You can try changing the fixed version dependency to a range constraint, such as open_clip_torch>=2.26.1, and then reinstall the dependencies to resolve these issues.

Environment pollution

During the installation of custom node dependencies, it may overwrite versions of libraries already installed by other plugins. For example, multiple plugins may depend on PyTorch but require different CUDA versions, and the later installed plugin will break the existing environment. Solutions:

You can try manually installing specific versions of dependencies in the Python virtual environment to resolve such issues.
Or create different Python virtual environments for different plugins to resolve these issues.
Try installing plugins one by one, restarting ComfyUI after each installation to observe if dependency conflicts occur.

Custom node dependency versions incompatible with ComfyUI dependency versions

These types of dependency conflicts may be more difficult to resolve, and you may need to upgrade/downgrade ComfyUI or change the dependency versions of custom nodes to resolve these issues. Solution: These types of dependency conflicts may be more difficult to resolve, and you may need to upgrade/downgrade ComfyUI or change the dependency versions of custom nodes to resolve these issues.

Models

Models are a significant asset dependency for ComfyUI. Various custom nodes and workflows are built around specific models, such as the Stable Diffusion series, Flux series, Ltxv, and others. These models are an essential foundation for creation with ComfyUI, so we need to ensure that the models we use are properly available. Typically, our models are saved in the corresponding directory under ComfyUI/models/. Of course, you can also create an extra_model_paths.yaml by modifying the template to make additional model paths recognized by ComfyUI. This allows multiple ComfyUI instances to share the same model library, reducing disk usage.

Software

An advanced application like ComfyUI also has software dependencies. These are libraries of programming code and data that are required for the application to run. Custom nodes are examples of software dependencies. On an even more fundamental level, the Python programming environment is the ultimate dependency for ComfyUI. The correct version of Python is required to run a particular version of ComfyUI. Updates to Python, ComfyUI, and custom nodes can all be handled from the ComfyUI Manager window.

Get Started

Agent Tools

ComfyUI Reference

Interface Guide

Tutorials

Comfy Cloud Nodes

Partner Nodes

What a shared workflow may need

Assets

Custom Nodes

Python Dependencies

ComfyUI Dependencies

Custom Node Dependencies

Dependency Conflicts

Models

Software

​What a shared workflow may need

​Assets

​Custom Nodes

​Python Dependencies

​ComfyUI Dependencies

​Custom Node Dependencies

​Dependency Conflicts

​Models

​Software

What a shared workflow may need

Assets

Custom Nodes

Python Dependencies

ComfyUI Dependencies

Custom Node Dependencies

Dependency Conflicts

Models

Software