andyshaman/whisk-proxy/whisk-proxy

Flow Image Generator

Generate images using Google Imagen 4, Nano Banana, and Reference-to-Image for free. No API key — uses Chrome extension for OAuth.

Quick Start

# Generate 4 images (Imagen 4, default)
node {baseDir}/scripts/generate.mjs -p "a cat astronaut floating in space"
 
# Nano Banana (fast, creative)
node {baseDir}/scripts/generate.mjs -p "abstract painting in neon colors" -m banana
 
# Reference-to-Image (style transfer)
node {baseDir}/scripts/generate.mjs -p "watercolor portrait" -m r2i
 
# Portrait format, 1 image
node {baseDir}/scripts/generate.mjs -p "anime girl with headphones" -r 9:16 -c 1
 
# Save to specific folder
node {baseDir}/scripts/generate.mjs -p "sunset over mountains" -o ./images

Models

Options

Aspect Ratios

• 1:1 (1024x1024) — avatars, icons, social posts
• 16:9 (1365x768) — banners, covers, YouTube thumbnails
• 9:16 (768x1365) — stories, reels, vertical posters
• 4:3 — classic landscape
• 3:4 — classic portrait

Authentication

Token stored in ~/.flow-proxy/token.json. The Chrome extension handles auth automatically.

Check token status

node {baseDir}/scripts/status.mjs

First-time setup

1. Install the Chrome extension from {baseDir}/extension/ (load unpacked)
2. Open https://labs.google/fx/tools/flow
3. Sign in with Google
4. Click the Flow Proxy extension icon → "Connect"

Token auto-refreshes via session cookie (~30 days). After that, repeat step 4.

If token is expired

The CLI script auto-detects expired tokens and starts a local auth server. Just click "Connect" in the Chrome extension — no manual token copying needed.

The agent should check status.mjs first. If token is expired, run generate.mjs — it will start the auth server and wait for the extension. Tell the user to click "Connect" in the extension.

Important

• Prompts in English produce best results
• The API is free but rate-limited (Google account level)
• Images saved as PNG
• Do NOT read generated PNG files into context — they consume thousands of tokens