ComfyUI-IF_Gemini

ComfyUI-IF_Gemini
★ 68

多模态图像生成文本生成批量与会话
ComfyUI-IF_Gemini 在 ComfyUI 中集成 Google Gemini V2 API，支持文本生成、图像分析与多模态图像生成，便于可控批量与会话式交互。
💡 在ComfyUI用Gemini进行多模态图像生成与分析
🍴 9 Forks💻 Python🔄 2025-09-03
📦
网盘下载
复制链接后前往夸克网盘下载
https://pan.quark.cn/s/9671236b7e59
📦 requirements.txt
torch
pillow
numpy
python-dotenv
google-generativeai
google-genai
📄 README

ComfyUI-IF_Gemini

Enjoy Google Gemini API for ComfyUI generate images, transcribe audio, sumarize videos. Making a separate implemetation of my old IF_AI tools for easy installation

Features

  • Text Generation: Create content, answer questions, and generate creative text formats
  • Image Analysis: Describe, analyze, and extract information from images
  • Image Generation: Generate images with Gemini’s image generation capabilities
  • Multi-Modal Input: Combine text and images in your prompts
  • Customizable Parameters: Control temperature, output tokens, and other generation settings
  • Chat Mode: Maintain conversation history for interactive sessions
  • Batch Processing: Generate multiple outputs with a single prompt

  • URL PROXY

    • Users can now configure a custom Gemini API endpoint in three ways:

  • Environment variable:

    • export GEMINI_BASE_URL=’https://your-proxy.com/gemini/v1′

  • In .env file:

    • GEMINI_BASE_URL=https://your-proxy.com/gemini/v1

  • In shell config (.bashrc/.zshrc):

    • export GEMINI_BASE_URL=’https://your-proxy.com/gemini/v1′

    NEW OPEN ROUTER

    🚀 Usage Examples

    Method 1 – Environment Variables:

    export OPENROUTER_API_KEY=”sk-or-v1-your-key”

    export OPENROUTER_PROXY=”true”

    Method 2 – Direct Configuration:

    export OPENROUTER_API_KEY=”sk-or-v1-your-key”

    export GEMINI_BASE_URL=”https://openrouter.ai/api/v1″

    Method 3 – External API Key:

    Just paste your OpenRouter key into the external_api_key field and use OpenRouter model

    names.

    🎨 Free Image Model Access

    Use model: google/gemini-2.5-flash-image-preview:free for completely free image analysis

    through OpenRouter!

    🔧 Files Modified

  • env_utils.py – Enhanced base URL and API key detection
  • gemini_node.py – Added OpenRouter client support and model names
  • OPENROUTER_README.md – Complete documentation
  • example.env – Configuration template

    • Installation

  • Clone this repository into your ComfyUI custom nodes folder:
    • cd ComfyUI/custom_nodes

git clone https://github.com/if-ai/ComfyUI-IF_Gemini

  • Install the required Python packages:
    • cd ComfyUI-IF_Gemini

pip install -r requirements.txt
  • Restart ComfyUI to load the new node

    • Usage

    The Gemini node appears in the “ImpactFrames💥🎞️/LLM” category in the ComfyUI node browser.

  • Restart ComfyUI
  • Add your Gemini API key using one of these methods:
  • Shell configuration file (recommended for macOS/Linux):

    • “`bash

    # In ~/.zshrc, ~/.bashrc, or ~/.bash_profile:

    export GEMINI_API_KEY=your_api_key_here

    “`

    Then restart your terminal or run source ~/.zshrc (or relevant file)

  • System environment variable:

    • “`bash

    export GEMINI_API_KEY=your_api_key

    “`

  • Directly in the node:

    • Enter your API key in the “external_api_key” field

  • In a .env file in the custom node directory:

    • “`

    GEMINI_API_KEY=your_api_key

    “`

  • Add the “IF LLM Gemini AI” node to your workflow

  • Verify your API key using the “Verify API Key” button in the node

  • Configure the node:
  • For text generation, set “operation_mode” to “analysis” or “generate_text”
  • For image generation, set “operation_mode” to “generate_images”
  • Connect reference images (optional) for style-based generation

  • Set additional parameters as needed:
  • Prompt: Your text instructions
  • Model version: Select appropriate Gemini model
  • Temperature: Controls randomness (0.0-1.0)
  • Seed: For reproducible results

    • Troubleshooting

  • If you encounter API key errors, use the “Verify API Key” button to check its validity
  • For image safety errors, try modifying your prompt to avoid content that may trigger safety filters
  • Ensure your Gemini API has appropriate quotas for your usage

    • License

    MIT

    Support

    If you find this tool useful, please consider supporting my work by:

  • Starring this repo on GitHub
  • Subscribing to my YouTube channel: Impact Frames
  • Follow me on X: Impact Frames X
  • Supporting me on Ko-fi: Impact Frames Ko-fi
  • Becoming a patron on Patreon: Impact Frames Patreon

    • Thank You!