Portable package for ComfyUI on Windows

＞💡中文说明点我💡＜

Just like ComfyUI official Standalone Portable, but preloaded with numerous custom nodes and Python packages, with all dependencies resolved.

The rest of README was translated by ChatGPT and edited by me (how lazy, how good😙).

Features

• Pre-installed with 30+ custom nodes including:

  • ComfyUI-3D-Pack which you may want to spend less time on installing.

  • Nodes like ReActor Node and Impact Pack that download model files on the first run (may cause freezing for users with bad Internet Connection)

  • See Full List

• Includes 240+ Python packages, versions compatible, including:

  • Packages like insightface, dlib and CLIP that require compilation.

  • xFormers. It’s not included in the ComfyUI official package (for a understandable reason). See details in About xFormers.

• Only a few functional models that might slow down the program startup are pre-installed; users please prepare SD models of your favorite.

• This repo uses the GitHub pipeline for packaging, making it easy for DIY. No need to configure CI/CD, simply fork the repository on GitHub to run the packaging script. See Creating Your Own AIO Package.

How to Use

1. Only NVIDIA GPUs are supported, preferably with the latest drivers installed.

2. Download the package files from the release page:

   • https://github.com/YanWenKun/ComfyUI-Windows-Portable/releases

   • Note that there are multiple files (compressed in volumes) that need to be downloaded and extracted.

3. Place SD models in ComfyUI\models\checkpoints.

   • Subdirectories can be created for better organization.

4. Edit and run run_nvidia_gpu.bat to start ComfyUI.

   • If you don’t want the browser to open automatically, add --disable-auto-launch to the startup arguments.

   • If you’re using 40/Ada series or newer GPU, you can try adding --fast to the startup arguments. It has magic.

5. After starting, the program will automatically open a browser, or you can visit: http://localhost:8188/

Important Prerequisites For 3D-Pack Users

Few steps before running Comfy3D:

1. Install Visual Studio Build Tools 2022 with "Desktop development with C++" workload. Its C＋＋ build tools will be needed (for some JIT code).

2. Install CUDA Toolkit 12.4.1. Only Libraries and Compilers are needed.

3. Edit run_nvidia_gpu.bat, reduce TORCH_CUDA_ARCH_LIST according to your GPU arch, to save your time on JIT compiling.

After successfully launching ComfyUI and loading the ComfyUI-3D-Pack, it is recommended to first run the TripoSR workflow, as the model files required for this workflow are smaller, execute faster, and have a high success rate.

Tips for Usage

1. Model Path: If model files are already saved in another location and you don’t want to move them, you can configure the program to load them:

   • Rename extra_model_paths.yaml.example in the ComfyUI directory to extra_model_paths.yaml.

   • Edit extra_model_paths.yaml according to the directory structure, removing corresponding comments.

   • Items other than base_path can be added or removed freely to map newly added subdirectories; the program will try load all of them.

2. Proxy: If a network proxy is needed, edit run_nvidia_gpu.bat and add the following at the beginning:

   set HTTP_PROXY=http://localhost:1081
   set HTTPS_PROXY=http://localhost:1081

3. Manager: Take advantage of the ComfyUI-Manager (the Manager button located at the bottom right corner of the ComfyUI page) to install additional custom nodes, update ComfyUI and nodes, or disable unnecessary nodes.

   • If you find that some unused nodes affect the startup time, you can disable them.

4. Language: Click the gear (⚙) icon at the top right corner of the ComfyUI page to modify settings. Find AGLTranslation to change the language (default is English, options are {Chinese, Japanese, Korean}).

5. How to upgrade: ComfyUI-Manager can do most updates, but if you want a "fresh" upgrade, you can first delete the python_embeded directory, and then extract the same-named directory from the new version’s package to the original location. Additional "try fix" in ComfyUI-Manager may be needed.

Details

Pre-installed Custom Node List

Table 1. Workspace

ComfyUI Manager	ComfyUI Translations
Crystools	ComfyUI-to-Python-Extension

Table 2. General

Comfyroll Studio	ComfyUI Essentials by cubiq
Derfuu Modded Nodes	Custom Scripts by pythongosssss
Efficiency Nodes by jags111	KJNodes
Mikey Nodes	rgthree Nodes
smZ(shiimizu) Nodes	Use Everywhere
WAS Node Suite	ComfyUI-Easy-Use

Table 3. Control

Advanced ControlNet	ControlNet Auxiliary Preprocessors
Impact Pack	Inspire Pack
InstantID by cubiq	IPAdapter plus
PuLID by cubiq	LayerDiffuse
Portrait Master	ReActor Node
SD Dynamic Thresholding	SDXL Prompt Styler
Segment Anything

Table 4. Video

AnimateAnyone Evolved	AnimateDiff Evolved
FizzNodes	Frame Interpolation (VFI)
MTB Nodes	Video Helper Suite

Table 5. More

3D Pack by MrForExample	Face Analysis by cubiq
Image Selector	Ultimate SD Upscale
WD 1.4 Tagger	ComfyUI-GGUF

Most of the popular custom nodes are denpendency-compatible. You can install more custom nodes through ComfyUI-Manager.

If compatibility issues arise, you can try disabling conflicting nodes in ComfyUI-Manager.

About xFormers

The cross-attention mechanism in PyTorch 2.2+ performs well on Windows and is more consistent (albeit subtly), so it’s understandable why the ComfyUI official package chose not to include xFormers.

However, there is still a strong demand for xFormers in 3D and video-related components, so it has been retained for compatibility.

To disable xFormers, add --use-pytorch-cross-attention to the ComfyUI startup parameters.

There is no definitive conclusion about the performance of the two; specific testing is required.

Creating Your Own AIO Package

This repository utilizes a pipeline to build the integration package, and the codebase doesn’t contain specific configurations or require additional access permissions. Hence, you can directly fork this repository to start executing the GitHub Workflow.

1. After forking, go to Actions on the page.

2. Locate Build & Upload Package.

   • For example, it looks like this on my repository page.

3. Click Run Workflow.

4. Wait about 20~40 minutes until the workflow run complete.

   • If you want to speed up the compression process, edit stage3.sh and set the parameters to -mx=3 -mfb=32 -md=4m. This adjustment will reduce the workflow duration to under 15 minutes, at the cost of a larger file size.

5. Go to the releases page of your repository, where you’ll find the newly generated draft for download or publish.

Temp Files

Files detected by Sandboxie as shown in the image; registry changes are not clear.

If you need to configure a sandbox, it is recommended to set the program directory (the parent directory of ComfyUI) to "Full Access" under "Resource Access."

Complaints

In my personal experience, I use a sandbox not so much for security considerations but mainly to avoid various Python packages downloading files haphazardly. Especially Huggingface Hub likes to download to %USERPROFILE%\.cache, and some rough and ready nodes directly call its downloader, downloading Git LFS blob files rather than individual model files, which are neither intuitive nor convenient for copying and reusing. Of course, despite the complaints, sandboxing is mainly for easy cleaning of temporary files.

Advertisement

Linux/WSL2 users may want to check out my ComfyUI-Docker, which is the exact opposite of the Windows integration package in terms of being large and comprehensive but difficult to update. I designed the Docker image with a meticulous eye, selecting a series of non-conflicting and latest version dependencies, and adhering to the KISS principle by only including ComfyUI-Manager, leaving the choice of custom nodes to the users. Not to mention the benefits of easy upgrades, easy cleanup, and secure isolation provided by container runtime itself.

Development Idea

Originally, the code was copied from ComfyUI’s GitHub workflow, but I found it difficult to debug, so I rewrote the script.

However, the packaging concept is similar: providing a self-contained, portable, and fully equipped environment with a pre-installed Python Embedded.

The difference is that I didn’t download wheels first and then install them in bulk like comfyanonymous did. Because dependency relationships are too tricky, I went straight to pip install for dependency solving.

Development Memo

• Development Memo - Version Upgrades

See Also

• How To: Manually Setup ComfyUI

Thanks

Thanks to the ComfyUI GitHub workflow, from which I drew inspiration. The initial code was also copied from there.