ComfyUI Node: FL NFT Generator

FL NFT Generator:

The FL_NFTGenerator node is designed to facilitate the creation of NFTs (Non-Fungible Tokens) by selecting images from a specified folder based on rarity percentages embedded in the filenames. This node is particularly useful for AI artists looking to generate unique digital assets with varying degrees of rarity, which is a common requirement in the NFT space. By leveraging a dummy seed for randomization, the node ensures reproducibility and fairness in the selection process. The primary goal of this node is to streamline the NFT generation process, making it easier for artists to create and manage collections of digital art with distinct rarity attributes.

FL NFT Generator Input Parameters:

folder_path

The folder_path parameter specifies the directory containing the images to be used for NFT generation. This parameter is crucial as it directs the node to the location of the image files. The folder path must be a valid directory; otherwise, the node will raise an error. The default value is an empty string, indicating that the user must provide a valid path. This parameter does not have a minimum or maximum value but must be a valid string representing a directory path.

dummy_seed

The dummy_seed parameter is an integer used to seed the random number generator, ensuring reproducibility in the selection of images. This parameter allows you to control the randomness of the NFT generation process. The default value is 0, and it can range from 0 to 1,000,000. Setting the seed to 0 will result in a different random selection each time, while any other value will produce the same selection for the same seed, ensuring consistency.

FL NFT Generator Output Parameters:

IMAGE

The IMAGE output parameter represents the selected image from the specified folder based on the rarity percentages and the dummy seed. This output is crucial as it provides the final image that will be used as an NFT. The image is selected through a probabilistic process, ensuring that rarer images have a lower chance of being selected, thus maintaining the intended rarity distribution.

IMAGE

The second IMAGE output parameter is identical to the first and serves the same purpose. It provides an additional copy of the selected image, which can be useful for further processing or for creating variations of the NFT.

FL NFT Generator Usage Tips:

• Ensure that the filenames of your images include rarity percentages in the correct format (e.g., name-10per.png) to enable the node to calculate probabilities accurately.
• Use a consistent dummy seed if you want to reproduce the same selection of images across different runs. This is particularly useful for testing and validation purposes.
• Verify that the folder path provided is correct and contains the images you intend to use for NFT generation to avoid errors and ensure smooth operation.

FL NFT Generator Common Errors and Solutions:

Folder path does not exist: <folder_path>

• Explanation: This error occurs when the specified folder path is invalid or does not exist.
• Solution: Double-check the folder path to ensure it is correct and that the directory exists.

No image files found in the folder: <folder_path>

• Explanation: This error indicates that the specified folder does not contain any image files.
• Solution: Make sure the folder contains image files and that they are not filtered out by the node's criteria (e.g., filenames ending with -mask).

Invalid image filename format: <image_file>

• Explanation: This error occurs when an image file does not follow the expected naming convention for rarity percentages.
• Solution: Rename the image files to include rarity percentages in the correct format (e.g., name-10per.png).