ComfyUI Node: 🔧 Dependency Installer

🔧 Dependency Installer:

The ArchAi3D_Dependency_Installer is a powerful utility node designed to streamline the installation of necessary dependencies for the ArchAi3D suite of nodes. This node simplifies the often complex process of setting up the required software environment by automatically detecting your system's GPU, CUDA, and PyTorch versions to ensure the correct packages are installed. Its primary goal is to provide a one-click solution for installing all dependencies, making it an essential tool for AI artists who want to focus on their creative work without getting bogged down by technical setup issues. By ensuring that all necessary components are correctly installed, the ArchAi3D_Dependency_Installer helps maintain a smooth and efficient workflow, allowing you to leverage the full capabilities of the ArchAi3D nodes.

🔧 Dependency Installer Input Parameters:

action

The action parameter allows you to specify the type of installation or system check you wish to perform. It offers several options, including "Check System," "Install Core," "Install SAM3," "Install Metric3D," "Install Color Tools," "Install API Tools," "Install All," and "Upgrade PyTorch (Blackwell)." Each option corresponds to a specific set of dependencies or actions, enabling you to tailor the installation process to your needs. The default value is "Check System," which provides a status report on the current installation state. This parameter is crucial for directing the node's operation and ensuring that the correct dependencies are installed based on your specific requirements.

include_optional

The include_optional parameter is a boolean setting that determines whether optional dependencies should be included in the installation process. By default, this parameter is set to True, meaning that optional packages will be installed alongside the core dependencies. This option is particularly useful if you want to ensure that all potential features and functionalities are available, but it can be set to False if you prefer a more minimal installation. This parameter allows you to customize the installation scope, balancing between a comprehensive setup and a leaner, more focused environment.

🔧 Dependency Installer Output Parameters:

status

The status output parameter provides a string that summarizes the result of the installation or system check action performed by the node. This output is essential for understanding the outcome of the node's execution, as it includes information about which dependencies were successfully installed, any that may have failed, and the overall status of the system's readiness. By reviewing the status output, you can quickly assess whether further action is needed to complete the setup or if the system is fully prepared for use with the ArchAi3D nodes.

🔧 Dependency Installer Usage Tips:

• Use the "Check System" action first to get an overview of which dependencies are already installed and which ones need attention. This can save time by avoiding unnecessary installations.
• If you are unsure about which specific dependencies you need, opt for the "Install All" action to ensure a comprehensive setup that covers all potential use cases.
• Regularly check for updates to PyTorch and CUDA, especially if you are using newer GPU architectures, to ensure compatibility and optimal performance.

🔧 Dependency Installer Common Errors and Solutions:

Dependency installation failed

• Explanation: This error may occur if there is a network issue or if the package repository is temporarily unavailable.
• Solution: Check your internet connection and try running the installation again. If the problem persists, verify that the package repository URLs are correct and accessible.

Incompatible PyTorch version

• Explanation: This error indicates that the installed PyTorch version is not compatible with your GPU or CUDA version.
• Solution: Use the "Upgrade PyTorch (Blackwell)" action to update PyTorch to a version that supports your hardware configuration. Ensure that your CUDA drivers are also up to date.

Missing CUDA toolkit

• Explanation: This error suggests that the CUDA toolkit required for GPU acceleration is not installed on your system.
• Solution: Install the appropriate version of the CUDA toolkit for your GPU. The ArchAi3D_Dependency_Installer can help identify the correct version based on your hardware.