Skip to content

Ali-Kabbadj/All_In_One_ComfyUI_Manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 

Repository files navigation


All-In-One ComfyUI Manager

Welcome to the All-In-One ComfyUI Manager, a comprehensive PowerShell script designed to automate the installation, management, and replication of a stable and feature-rich ComfyUI environment. This manager is built for artists, developers, and enthusiasts who want a powerful, reproducible, and hassle-free ComfyUI setup without the complexities of manual dependency management.

The core philosophy of this project is stability through precision. It builds a Python virtual environment from a specific, tested list of packages, ensuring that all custom nodes and core components work together seamlessly.

Core Features

  • One-Click Fresh Install: Automatically clones the ComfyUI repository, clones a curated list of over 70 popular custom nodes, and builds the complete Python environment in a single operation.
  • Perfect Venv Replication: Rebuilds the ComfyUI virtual environment to an exact, predefined state, eliminating version conflicts and ensuring a stable workflow.
  • Dependency Protection: Creates a constraints.txt file after the initial setup to "lock" core packages like PyTorch, xFormers, and CUDA-related libraries. This prevents custom nodes from accidentally breaking your installation.
  • Safe Custom Node Updates: Intelligently installs and updates requirements for custom nodes while respecting the protected core packages, giving you the best of both worlds: stability and extensibility.
  • Automated Launcher Generation: Creates multiple convenient .bat launcher scripts for different use cases (High VRAM with SageAttention or xFormers, Low VRAM, CPU-only) and a direct-access venv shell.
  • Pre-flight Checks: Verifies that all essential prerequisites like Git, Visual Studio Build Tools, and the correct CUDA version are available before starting any operations.
  • Backup and Restore: Automatically backs up the existing virtual environment before a rebuild, allowing you to easily restore the previous state if needed.
  • Recovery and Logging: Includes a "Continue Failed Installation" option to recover from network errors and logs every operation to a file for easy troubleshooting.

The Philosophy: Why This Script Exists

The ComfyUI ecosystem is incredibly dynamic, with new custom nodes and features appearing daily. This rapid development can lead to a fragile environment where installing one node breaks another, or a core dependency update causes widespread instability.

The All-In-One ComfyUI Manager solves this by treating the environment like a production system. It uses a master package list (venv_master_freeze.txt) that defines the exact version of every Python library required for a known-good state. Once this stable foundation is built, it's protected, allowing for the safe installation of custom node dependencies without risking the core setup.

This approach provides the reliability of a fixed environment with the flexibility to use the latest community creations.

❗ Critical Prerequisites

Before running the script, you MUST have the following software installed and configured. The script is opinionated and requires these exact versions to ensure perfect replication.

1. Git Source Control Manager

Required for cloning ComfyUI and all custom nodes.

2. Python 3.12

The target environment is built on Python 3.12.

3. NVIDIA CUDA Toolkit 12.8

This EXACT version is required for the specific PyTorch build used in this configuration.

4. Visual Studio 2022 Build Tools

Required for compiling certain Python packages.

5. Administrator Privileges

The script requires Administrator rights to create directories and manage the environment effectively.

6. External Wheel Files (.whl)

Certain high-performance packages require specific pre-compiled versions. You must download these manually.

  1. After cloning this repository, create a folder named ComfyUI (if you are not doing a fresh install).
  2. Inside the ComfyUI folder, create another folder named externals.
  3. Download the following three .whl files and place them inside the ComfyUI/externals folder:
    • SageAttention:
      • File: sageattention-2.2.0+cu128torch2.8.0-cp312-cp312-win_amd64.whl
      • Download: Link
    • Nunchaku:
      • File: nunchaku-1.0.1+torch2.8-cp312-cp312-win_amd64.whl
      • Download: Link
    • Triton for Windows:
      • File: triton-3.2.0-cp312-cp312-win_amd64.whl
      • Download: Link

RESTART YOUR COMPUTER after installing the prerequisites to ensure all environment variables are correctly loaded.

How to Use

  1. Clone this Repository:
    git clone https://github.com/Ali-Kabbadj/All_In_One_ComfyUI_Manager.git
  2. File Locatoin: Copy the ComfyUIManager.ps1 from cloned folder and put it next to your ComfyUI directory.
  3. Ensure Prerequisites: Double-check that you have completed all steps in the "Critical Prerequisites" section.
  4. Launch the Correct Terminal: Open the "x64 Native Tools Command Prompt for VS 2022" from your Start Menu as an Administrator.
  5. Run the Script:
    powershell.exe -ExecutionPolicy Bypass -File .\ComfyUIManager.ps1
  6. Choose an Option from the Menu.

Management Menu Options

  • [1] Fresh Install of ComfyUI & Venv: The best option for new users. It handles everything: cloning ComfyUI, cloning all custom nodes, and building the protected virtual environment from scratch.
  • [2] Rebuild Venv for Existing ComfyUI: Use this if you already have a ComfyUI folder. It will back up your current venv and build a new, perfect one according to the master list.
  • [3] Update Custom Node Requirements: Safely run this after adding a new custom node to install its dependencies without breaking your core setup.
  • [4] Restore Previous Venv from Backup: Reverts to the last environment that was backed up by option.
  • [5] Continue Failed Installation: If your installation was interrupted (e.g., by a network error), this option lets you resume from the 'externals' installation step without starting over.
  • [0] Exit: Exits the script.

Included Custom Nodes

This manager automatically installs a powerful and curated list of custom nodes to provide a comprehensive, ready-to-use ComfyUI experience.

Future Development & Roadmap

This project aims to become a true "zero-touch" installer. Future goals include:

  • Automated Prerequisite Installation: Integrating checks and optional automated installers for prerequisites like Python, Git, and the Visual Studio Build Tools workload using PowerShell package managers (like Chocolatey or Winget).
  • Automatic Downloader for Externals: A function to automatically fetch the required .whl files from their GitHub release pages, removing the final manual download step.
  • CUDA Toolkit Automation: Providing guidance or potentially automating the installation of the NVIDIA CUDA Toolkit.
  • Model Management: Adding features to download and organize popular base models, VAEs, and LoRAs into the correct ComfyUI directories.

Contributions and suggestions are always welcome. Please feel free to open an issue or submit a pull request.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published