Nano Banana Pro | Future Lab Edition 🍌

The Ultimate Single-File Interface for Gemini 3 Pro + Fal AI.

Nano Banana Lab is a serverless, local-first "Lab Environment" for power users pairing Google's Gemini 3 Pro image generation with Fal AI workflows (Z-Image Turbo / Qwen Image, Flux Inpaint, SeedVR Upscale). It combines the simplicity of a single HTML file with the power of a desktop-class asset management system.

It features direct disk synchronization, advanced batching, multimodal reference injection, multi-provider routing, custom Fal payloads, and a persistent local database.

⚠️ System Requirement: Requires a Chromium-based browser (Chrome, Edge, Brave, Opera) on Desktop to leverage the File System Access API. Firefox and Safari are not currently supported.

---

UI Preview

---

⚡ Core Features

1. Zero-Install & Serverless

The entire application lives in one file: nano.html. No Node.js, Python, or Docker required. Just download, open, and generate.

2. Direct Disk Sync (The "Hard Link")

Unlike web apps that dump files into "Downloads," Nano Banana Pro binds directly to a folder on your drive.

• Real-time Saving: Images are written to disk instantly upon generation.
• Metadata Pairing: Every image is saved with a matching .json file containing the prompt, parameters, and timestamps.
• Two-Way Sync: The app reads your folder state on startup, syncing your local library with the browser view.

3. Parallel Execution Protocol

• Batch Processing: Generate up to 20 images simultaneously.
• API Key Rotation: Add multiple API keys per provider. The system automatically cycles through them to maximize throughput and manage rate limits.
• Auto-Retry: Built-in exponential backoff handles network glitches or API overloading automatically.

4. Multi-Provider Engine (New)

• Provider Switch: Toggle between Google Gemini 3 Pro and Fal AI.
• Fal Models: Z-Image Turbo (default) or Qwen Image (gen/edit).
• Image-to-Image: When using Fal, the first reference image becomes the I2I input automatically.

5. Hybrid Persistence Layer

• IndexedDB Cache: A high-performance local database caches your session, allowing you to load thousands of past results without cluttering memory.
• State Recovery: Accidentally closed the tab? Pending tasks and unread results are restored instantly upon reopening.

6. Post-Processing Labs (New)

• Image Editor (T): Crop, rotate, adjust, and inpaint masked areas (Fal Flux Pro).
• AI Upscale (U): SeedVR upscale with factor + noise control (Fal).
• Compression/Resample (R): Built-in JPEG optimization with split-view compare.

---

🎮 Pro Workflow & Hidden Features

Nano Banana Pro is packed with hidden interactions designed for speed.

📂 Advanced List Management & Reuse

• Create & Delete: Create unlimited lists to organize projects (e.g., "Concepts", "Finals").
• Smart Reuse:
  • Click REUSE: Loads the prompt, settings, and reference images from that card.
  • Cmd/Ctrl + Click REUSE: Loads only the Prompt (ignoring reference images and settings).
• Drag-to-Reorder: Drag the list tabs themselves to reorder your workspace.
• Drag-to-Move: Drag a result card and drop it onto a specific List Tab to move it there.
• Quick Rename: Double-click any list tab to rename it instantly.
• Mass Migration: Press M to open the List Transfer overlay and move every task in the current list to another list.

⌨️ Keyboard Shortcuts (The "Lab Secrets")

Master the interface with these undocumented hotkeys:

Key	Action	Description
R	Compress	Opens the Compression Lab to resize/optimize the current image.
T	Image Editor	Crop/rotate/adjust/inpaint the current image (Lightbox only).
U	Upscale	Opens AI Upscale (Lightbox only; Fal key required).
V	Copy	Copies the current image to your system Clipboard.
P	Edit Metadata	Enter Edit Mode; click a card to edit prompt/resolution/aspect.
Q	Quick Locator	Instantly scrolls to and highlights the last viewed image in the feed.
F	Jump to Ref	Switches the active view to the REF (Reference) list immediately.
M	Move Overlay	Toggles the "Move to List" panel (when not in Lightbox).
W	Compare Mode	Enter split-view compare selection; pick two cards to compare.
Alt + Enter	Custom Task	Opens the Fal Custom Task overlay from the prompt input.
Esc(E)	Close / Cancel	Closes the Lightbox, Compression Lab, or cancels Import dialogs.
←(A) / →(D)	Navigation	Navigate through pages or images.
Z	Zoom In	Incrementally zoom into the image (Lightbox only).
X	Zoom Out	Incrementally zoom out (Lightbox only).
C	Center/Reset	Reset zoom level to 100% (Lightbox only).

🧩 Metadata Editing & Import Notes (New)

• Import w/ Notes: Use IMPORT IMAGE or drag into the output stream to create cards with optional prompt/resolution/aspect notes.
• Edit Mode: Press P, then click a card to update its prompt/resolution/aspect (synced to disk metadata).

🧰 Image Editor & Inpaint (New)

Open the Lightbox and press T.

• Tools: Crop, rotate, brightness/contrast/saturation/grayscale adjustments.
• Inpaint: Paint a mask + enter a prompt to fill areas (Fal Flux Pro).
• Save Paths: Save as New or Overwrite the original.

🔬 AI Upscale (New)

Press U in the Lightbox.

• SeedVR Upscale: Set upscale factor + noise.
• Result: Saved as a new card (Fal API key required).

🧪 Custom Task Protocol (Fal) (New)

Press Alt + Enter inside the prompt field to open the Custom Task overlay.

• Endpoint + Payload: Define any Fal endpoint path and a custom payload schema.
• Auto-Injection: Prompt and the first reference image are injected automatically.
• Local Profile: Your payload config is saved in LocalStorage for reuse.

🧪 Split-View Compare Mode (New)

Press W to enter Compare Mode, then click any two result cards.

• Live Scrub: Drag the vertical divider to compare before/after or variant differences.
• Zoom & Pan: Scroll to zoom; drag to pan when zoomed.
• Exit: Esc or E.

🖼️ Compression & Resample Lab (New)

A built-in studio for post-processing your generations without leaving the app. Open any image in the Lightbox and press R.

• Smart Resize: Scale by percentage (e.g., 50%) or define exact pixel dimensions.
• Live Split-View: Drag the divider to compare the original vs. compressed result in real-time.
• Non-Destructive: Choose to Replace the original file to save space, or Save as New to keep both.
• Metrics: See exactly how much disk space you're saving before committing.

🖱️ Drag & Drop Mechanics

• External Import: Drag images from your OS into the generation panel to use them as References.
• Output Import: Drag images into the output stream (or use IMPORT IMAGE) to create cards in the active list.
• Self-Referencing: Drag a generated result back into the "Reference Input" zone to iterate on a style.
• Sort & Organize: Drag result cards to reorder them visually within the stream.

---

⚙️ Configuration Guide

1. Provider & API Keys:

• Select a provider (Google or Fal AI) in the Configuration panel.
• Get your Google key from Google AI Studio.
• Get your Fal key from Fal AI.
• Tip: Click + Add Key to input multiple keys per provider for heavy batch workloads.
• Fal Models: Z-Image Turbo (default) or Qwen Image (gen/edit).
• Fal Features: Inpaint, Upscale, and Custom Tasks require a Fal API key even if you generate with Google.

2. Reference Inputs (Multimodal):

• Supports image/png, image/jpeg, and image/webp.
• Limit: Up to 14 reference images per generation task (Gemini).
• Fal I2I: The first reference image is used for Fal image-to-image.
• Clipboard Paste: Use the PASTE button to add an image from your clipboard.
• Prompting: The model treats these as visual context. Use the prompt to describe how to use them (e.g., "Use the composition of image 1 and the style of image 2").

3. Output Files:

• Images are saved as nano-{timestamp}-{random}.png.
• Metadata is saved as nano-{timestamp}-{random}.json.

---

🛠️ Troubleshooting

"Output directory not bound"

• Browsers reset file permissions on restart for security. You must click the "Re-authorize" button in the header each time you open the app.

"Quota Exceeded" (429 Error)

• This means you hit the Google API rate limit.
• Solution: Add more API keys to the rotation pool or enable "Auto-Retry" in settings.

"Fal task failed / Missing Fal API Key"

• Inpaint, Upscale, and Custom Task workflows require a Fal API key.
• Switch the provider to Fal AI and add at least one key in Configuration.

"Reset All"

• The hidden ⚠ RESET ALL button (top right) performs a factory reset. It wipes LocalStorage (settings/keys) and IndexedDB (history). Use with caution.

---

🔒 Privacy & Architecture

• Local-First: All logic runs in your browser.
• Direct Connection: Requests go directly from your browser to generativelanguage.googleapis.com (Google) and fal.run (Fal). No middleman servers.
• Data Ownership: Your keys and images never leave your control.

---

📄 License

MIT License. Open source and free to modify. Built with Vibe Coding.