Skip to content

akatz-ai/ComfyUI-Environment-Manager

Repository files navigation

ComfyUI Environment Manager

If you find this tool helpful, please consider giving this repo a star!

For a more in-depth guide see the Notion Guide

Get help instantly using my Custom GPT!

Logo

🌟 Why Use the Environment Manager?

Common Challenges with ComfyUI

  • Custom Node Installation Issues: Installing new nodes can break your setup.
  • Workflow Compatibility: Workflows often depend on specific custom nodes and ComfyUI versions.
  • Security Risks: Directly installing custom nodes on your machine increases exposure to malicious code.

How This Tool Helps

  • Environment Duplication: Safely experiment with new setups by duplicating your current environment.
  • Environment Sharing: Share and download pre-configured environments via DockerHub.
  • Enhanced Security: Isolate ComfyUI in containers to protect your host machine.

usage_h264.mp4

🚀 Features

  • 🛠️ Create Environments: Set up isolated ComfyUI instances with specific versions and dependencies.
  • 📑 Duplicate Environments: Safely test changes or updates without affecting your main setup.
  • 🌍 Environment Sharing: Export and share your environment to ensure workflow compatibility.
  • 🔧 Custom Node Support: Easily install and manage custom nodes.
  • ⚙️ Advanced Options: GPU acceleration, runtime settings, and more.

🛠️ Installation

install_h264.mp4

Prerequisites

  • OS: Windows or Linux (macOS supports CPU only).
  • Docker: Docker Desktop or Docker Engine with NVIDIA Container Toolkit.
  • NVIDIA Drivers: Ensure they are up-to-date.
  • WSL (Windows Only): Latest version installed and updated.

Steps

  1. Install Docker Desktop:

    • Follow the installation guide for your OS.
    • Verify installation:
      wsl docker --version
  2. Install the Environment Manager using Pinokio:

    • Download Pinokio from here.
    • Use Discover > Download from URL and paste:
      https://github.com/akatz-ai/ComfyUI-Environment-Manager
      
    • Follow the installation process.
  3. Launch the Environment Manager:

    • Open Pinokio and start the ComfyUI Environment Manager.
    • Ensure Docker is running.

Running Without Pinokio on Windows:

  1. Navigate to a desired folder to clone this repo:

    • Open File Explorer.
    • Browse to the folder where you want to clone the repo.
  2. Open Command Prompt:

    • Right-click inside the folder.
    • Select Open in Terminal or Open Command Window Here (depending on your system).
  3. Clone the Repo:

    • Run the following command in the terminal:
git clone https://github.com/akatz-ai/ComfyUI-Environment-Manager.git
  1. Navigate to the Script:

    • Open the newly created ComfyUI-Environment-Manager folder.
    • Go to the scripts/ directory.
  2. Run the Script:

    • Right-click on start_windows.ps1.
    • Select Run with PowerShell.

📖 Usage

Manager Layout

Logo
  • Settings Panel: Configure ComfyUI defaults (path, port, runtime, etc.).
  • Environments Grid: Manage your environments.

Creating a New Environment

create_h264.mp4
  1. Click Create Environment.
  2. Fill in the fields:
    • Name: Alphanumeric, e.g., comfy-env-01.
    • ComfyUI Release: Choose a specific version or "latest."
    • Environment Type:
      • Default: Mounts input/output directories from your host machine.
      • Custom: Specify mounts and data copying behavior.
  3. Click Create to finalize setup.

Duplicating an Environment

dup_h264.mp4
  • Use the Duplicate button on an existing environment.
  • Mounted directories are not copied, but installed dependencies and container data are included.

Managing Environments

  • Activate: Start the environment (status turns green when running).
  • Settings: Update environment details.
  • Logs: View the environment's real-time output.
  • Delete: Remove an environment (mounted host directories are preserved).

🛡️ Troubleshooting

Slow Model Loading

  • Speed up loading times by moving model files to a WSL installation.
  • Access WSL paths in File Explorer:
    \\wsl.localhost\<distro>\<path-to-directory>
    

Dependencies:

https://github.com/akatz-ai/ComfyUI-Environment-Docker

https://github.com/akatz-ai/ComfyUI-Environment-Frontend


👨‍💻 About the Author

Akatz AI:

Contacts:


Enjoy the tool? Don’t forget to star the repo and share it with your community!

About

A Pinokio application to manage ComfyUI environments.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published