ComfyUI Node: Load ICLight Model

Load ICLight Model:

The ICLightModelLoader node is designed to load and manage the weights of ICLight models, which are specialized models used in AI art generation. This node ensures that the correct model weights are loaded securely and efficiently, converting them to a hardware-optimized precision for better performance. By using this node, you can seamlessly integrate ICLight models into your workflow, enabling advanced lighting effects and enhancements in your AI-generated art. The primary goal of this node is to facilitate the loading process of ICLight models, ensuring that they are ready for use in various artistic applications.

Load ICLight Model Input Parameters:

iclight_name

The iclight_name parameter specifies the name of the ICLight model you wish to load. This parameter is crucial as it determines which model weights will be retrieved and loaded into the system. The function checks for the existence of the specified model file and raises an exception if the file is not found. This ensures that only valid and available models are loaded, preventing errors during the execution. The available options for this parameter are dynamically retrieved from the folder containing ICLight models.

Load ICLight Model Output Parameters:

iclight

The iclight output parameter returns a tuple containing the loaded ICLight model information. This includes the model itself, a state dictionary (sd_dict) optimized for hardware precision, and a flag (fbc) indicating whether the model name contains the substring "fbc". This output is essential for subsequent nodes that apply the ICLight model to your AI art, as it provides all the necessary details and optimizations required for efficient processing.

Load ICLight Model Usage Tips:

• Ensure that the iclight_name parameter is correctly specified and corresponds to an existing model file in the designated folder. This will prevent errors related to missing files.
• Utilize the iclight output in conjunction with other nodes that apply or manipulate ICLight models to achieve advanced lighting effects in your AI-generated art.
• Regularly update your ICLight models to take advantage of the latest improvements and optimizations available.

Load ICLight Model Common Errors and Solutions:

Invalid ICLight model: <model_name>. File not found.

• Explanation: This error occurs when the specified ICLight model file does not exist in the designated folder.
• Solution: Verify that the iclight_name parameter is correctly specified and that the corresponding model file is present in the folder. Ensure that the file name is spelled correctly and matches the available options.

Attempted to load <model_type> model, IC-Light is only compatible with SD 1.5 models.

• Explanation: This error indicates that the model being loaded is not compatible with the ICLight system, which only supports SD 1.5 models.
• Solution: Ensure that you are using an SD 1.5 model. If you are unsure about the model type, check the documentation or metadata of the model to confirm its compatibility.