🔗 Workflow Editor

Visual node-based editor — connect processing steps into an automated image and video generation pipeline. Drag, connect, press RUN — the system handles batch processing automatically.

6.1 Interface

Toolbar

Other Areas

Canvas Interactions

6.2 Node Types Overview

Workflow has 8 node types (canonical set in node_executor.py):

6.3 Node Details

📦 Batch Image Loader

Source node — loads images from a folder to feed downstream processing nodes.

📝 Batch Prompt Loader

Source node — provides a list of prompts for image/video generation nodes.

🖼 Generate Image

Core processing node — receives prompt + reference images, calls AI API to generate images.

Inputs: Socket 1 = Reference image (from Ref node), Socket 2 = Prompt (from Batch Prompt). Output: Generated image (auto-previews on node).

🎬 Generate Video

AI video generation node — 2 selectable modes (Image-to-Video / Components).

🎨 Generate Grok (Grok AI)

Generates images/videos with Grok — 4 modes: T2I (text→image), I2I (image→image), T2V (text→video), I2V (image→video). Config: aspect ratio (9:16, 16:9, 1:1, 2:3, 3:2), video length 6s/10s, resolution 480p/720p. Requires a connected Super Grok account.

📎 Reference Image

Pick a single image from disk → feeds the reference socket of Generate Image / Video Generator. Only works with Nano Banana 2 / Nano Banana Pro models.

🎞 Extract Frame

Pulls the last frame of a video out as an Image. Used to chain videos: last frame of video 1 → Start Image of video 2.

💬 Prompt (Single Line)

Single-line text node — instead of typing a prompt directly into a Generate node. Useful when the same prompt feeds multiple Generate nodes.

6.4 Node Groups

• Right-click → New Group: Create a named grouping frame on the canvas
• Drag edges to resize groups
• Groups help organize complex workflows — cluster related nodes together
• Nodes inside a group move together when dragging the group

6.5 Execution

When pressing RUN FLOW, the system performs:

1. Topological sort — determines execution order based on connections. Detects and warns about cycles
2. Iteration count — number of loops = max(images in Batch Image, prompts in Batch Prompt)
3. Each iteration: feeds 1 image + 1 prompt (rotates if exhausted) → runs all processing nodes in order → saves results

6.6 Workflow Examples

Example 1: Batch image generation (basic)

Generate images from a prompt list, no reference images:

📝 Batch Prompt → 🖼 Generate Image → 💾 Save Image

1. Add 📝 Batch Prompt Loader — enter 10 prompts, Sequential mode
2. Add 🖼 Generate Image — select Nano Banana 2, Landscape ratio
3. Add 💾 Save Image — set prefix "nature", choose save folder
4. Connect: Prompt → Generate Image prompt socket → output → Save Image
5. Press RUN FLOW → system runs 10 iterations, one prompt each

Example 2: Image generation with references (advanced)

Use reference images from a folder for style transfer:

📦 Batch Images → 📎 Ref (Std) ↘
                                 🖼 Generate Image → 💾 Save
📝 Batch Prompt ───────────────↗

1. Add 📦 Batch Image Loader — select folder with 5 style images, sort A-Z
2. Add 📎 Reference Image — category: Style
3. Add 📝 Batch Prompt Loader — enter 5 matching prompts
4. Add 🖼 Generate Image — Nano Banana 2 model, Random seed
5. Connect: Batch Images → Ref → Generate Image ref socket. Batch Prompt → prompt socket
6. Press RUN FLOW → 5 iterations, each pairs 1 style image + 1 prompt

Example 3: Auto-match images to prompts

Image filenames are automatically paired with prompts containing matching keywords:

📦 Batch Images (Match Prompt) → 📎 Ref ↘
                                          🖼 Generate → 💾 Save
📝 Batch Prompt ────────────────────────↗

1. 📦 Batch Images — folder contains: cat.png, dog.png, sunset.png. Sort: Match Prompt
2. 📝 Batch Prompt — enter: "a cute cat sleeping", "a dog running on beach", "beautiful sunset over ocean"
3. When running: prompt "a cute cat sleeping" → auto-pairs with cat.png (filename matches)
4. Matching strategy: compares filename (without extension) against prompt text, prioritizes longest match

6.7 Save / Load