ComfyUI Node: ModelFinder

ModelFinder:

The ModelFinder node is designed to help you locate specific model files within a directory structure. It is particularly useful for AI artists who need to manage and utilize various models in their creative workflows. This node allows you to search for model files based on their filenames, type, and directory structure, providing a streamlined way to organize and access your models. By specifying search parameters, you can efficiently find the models you need, even in complex directory hierarchies. The node supports recursive searches and can handle missing files gracefully, making it a robust tool for managing large collections of models.

ModelFinder Input Parameters:

filenames

This parameter accepts a sequence of filenames that you want to search for within the specified directories. It allows you to specify multiple filenames, making it easier to locate all the models you need in one go. There are no specific minimum or maximum values for this parameter, but it should be a list of valid filenames.

model_type

This parameter determines the type of model you are searching for. It uses predefined folder types to narrow down the search to specific directories. The default value is set to a specific folder type, which can be customized based on your needs. This helps in organizing and categorizing your models effectively.

recursive

This boolean parameter specifies whether the search should be recursive, meaning it will look into subdirectories as well. The default value is True, enabling a thorough search through all nested folders. Setting it to False will limit the search to the top-level directory only.

skip_missing

This boolean parameter determines how the node handles missing files. If set to True, the node will skip any filenames that cannot be found and continue with the search. The default value is False, which means the node will raise an exception if any of the specified filenames are not found. This ensures that you are alerted to any missing files that might be critical to your workflow.

ModelFinder Output Parameters:

paths

This output parameter provides a sequence of paths to the found model files. Each path is a string representing the relative location of the file within the directory structure. This allows you to easily access and use the found models in your projects.

stems

This output parameter provides a sequence of the stem names of the found model files. The stem name is the filename without the directory path and file extension. This is useful for quickly identifying the models by their names without additional path information.

ModelFinder Usage Tips:

• To ensure a comprehensive search, keep the recursive parameter set to True, especially if your models are organized in nested directories.
• Use the skip_missing parameter set to True if you want to avoid interruptions in your workflow due to missing files.
• Organize your models into clearly defined folder types to make the most of the model_type parameter, which will help in quickly locating the required models.

ModelFinder Common Errors and Solutions:

"Could not find file: <filename>"

• Explanation: This error occurs when the specified filename cannot be found in the search directories.
• Solution: Ensure that the filename is correct and exists in the specified directories. If you want to ignore missing files, set the skip_missing parameter to True.

".. is not allowed: <filename>."

• Explanation: This error occurs when the filename contains the .. sequence, which is not permitted for security reasons.
• Solution: Remove the .. sequence from the filename and try again. Ensure that the filenames do not contain any invalid characters or sequences.