2025-11-27 16:45:18 -05:00
2025-11-27 16:45:18 -05:00
2025-05-15 06:44:53 -04:00
2025-11-27 16:45:18 -05:00
2025-11-27 16:45:18 -05:00

ComfyUI Projects

A collection of custom ComfyUI workflows and nodes created by Fred LeFevre.

Clone this repo into your ComfyUI/custom_nodes folder.

🚀 Update Notes

  • New: FSL Gemini & Veo Suite Added a full-stack cloud media suite (FSLGeminiNodes.py) powered by the new Google Unified SDK. Features include:

    • Gemini Chat Agent: A "Creative Director" that handles conversation and writes technical prompts.
    • Veo Video Generator: Supports Text-to-Video and True Image-to-Video (Identity Preservation).
    • Imagen 3 Generator: A lightweight, high-speed image generator.
    • Gatekeeper Logic: Nodes automatically "sleep" (costing $0) when you are just chatting with the agent.
  • Node Updates

    • Gemini Generate Image Node v8: Removed models that do not return images and added gemini-3-pro-image-preview.
    • Workflow Updates: All Nano Banana workflows have been updated to use the v8 node.

🧩 Custom Nodes: Comfyui_FSL_Nodes

Located in the Comfyui_FSL_Nodes/ directory.

🤖 Gemini & Veo Cloud Suite (New)

  • FSLGeminiChat (Unified SDK): The "Brain." Handles interactive chat, vision analysis, and prompt engineering. It outputs a MEDIA_PROMPT_HOOK to control downstream generators.
  • FSLVeoGenerator: The "Animator." Generates high-fidelity video using Google Veo (v3.1). Supports Image-to-Video (animating specific pixels) and Text-to-Video, with robust HTTP polling to handle large file downloads.
  • FSLImagenGenerator: The "Artist." A lightweight, native node for Google Imagen 3. Features "Smart Gatekeeping" to return a blank image instantly if the prompt is empty.

🛠️ Utility & Legacy Nodes

  • FSLGeminiGenerateImageV8.py: Legacy advanced image generator. Supports Inpainting, Masking, and Init Images for complex editing workflows not covered by the lightweight Imagen node.
  • FSLGeminiGenerateImage.py: This is the most current version of this node and will be the only one maintained going forward
  • manual_alpha_mask_painter.py: Manually convert black mask areas into alpha transparency. Essential for GRIPTAPE inpainting (which requires alpha channel masks).
  • 8WayImgSwitch: An image switcher with eight inputs.
  • fsl_image_memory.py: A set of 4 nodes (Store, Recall, Clear, Clear All) to save images into memory using a specific 'key' for complex workflow routing.
  • fsl_prompt_compose.py: Handles Positive/Negative prompts and "Scene Lock." When lock_scene is True, it injects instructions to freeze composition, lighting, and subjects while only changing specific details.
  • fsl_ensure_nhwc_batch.py: Guarantees incoming image tensors are converted to [N, H, W, C] layout, ensuring compatibility across different node packs.
  • FSLImageSaverWithMetadataV5.py: Saves images with embedded metadata, readable via the LoadImage-w-Metadata workflow.
  • fsl_composite_with_mask_cropped.py: [Legacy] Removes alpha channel but keeps transparent parts as background color.
  • fsl_save_and_strip_alpha: [Legacy] Strips alpha channel from RGBA images.

Located in the Comfyui_FSL_Nodes/ directory.


🎥 Workflow: Gemini Chat & Veo Video

  • Gemini_Chat.json
    • Concept: A "Creative Director" workflow. You chat with Gemini, and it intelligently decides whether to reply with text or generate media.
    • Text-to-Video: Ask for a video, and Gemini writes the prompt for Veo.
    • Image-to-Video: Upload an image and connect it to both Chat and Veo nodes. Gemini instructs Veo to "Preserve Identity," allowing you to animate specific characters or photos.
    • Requirements: Google API Key (Billing enabled for Veo).
    • **Note the field "enhance_hook". When enabled this will automatically use Gemini to enhance the prompt you have provided.

🍌 Workflow: Nano Banana (API Required)

  • Nano Banana Iterative-Base.json Create images using gemini-2.5-flash-image-preview. Supports iterative generation where each succeeding image is based on the previous one.
  • Nano Banana Iterative-Load 5 Images.json Uses up to 5 input images to create a new generation. Includes instructions in Note nodes.
  • Nano Banana w_Griptape w_Upscaler.json Uses Griptape Nodes as a front-end prompt loader. Includes an excellent upscaler by Alex (ComfyUiStudio). Requires an OpenAI API Key for Griptape.
  • Nano Banana img2img w_Griptape.json Griptape-assisted Image-to-Image workflow.
  • Nano Banana img2img Base.json Standard Image-to-Image workflow using Nano Banana.

Clarification: Init Image vs Image (v8 Node)

  • Iterative Workflow: Set Init-Image socket to True (and Images to False) after the first generation to loop the result back in.
  • Standard Workflow: Always set Images socket to True and Init-Image socket to False.

🎨 Workflow: T-shirt Designer

  • Tshirt-Designer-ver_2.0.json
    • Note: A less complex v3.0 replacement is pending.
    • Generates masked transparent images optimized for T-shirt and object printing.
    • Full workflow details available in the tshirt_designer/ directory.

📂 Miscellaneous Workflows

  • LoadImage-w-Metadata.json A simple utility workflow to read and display the metadata stored by the FSLImageSaverWithMetadataV5 node.

Acknowledgements

  • Alex (ComfyUiStudio): For the excellent upscaler included in the Nano Banana workflows.
  • Google DeepMind: For the powerful Gemini, Veo, and Imagen models driving these nodes.
  • Mycroft Holmes (ChatGPT)and Gemini 3: For assistance and guidance in the creation of Custom Nodes.

Author

Created and maintained by Fred LeFevre.

S
Description
No description provided
Readme
23 MiB
Languages
Python 100%