Nano Banana Helper is a powerful macOS application for batch processing image edits using Google's generative AI (Gemini). It allows users to orchestrate complex image transformation workflows, manage costs, and organize projects efficiently.
- Batch Orchestration: Process hundreds of images concurrently with robust queue management, including pause, resume, and cancel capabilities.
- Smart Staging: Drag and drop support for individual images or entire directories.
- Text-to-Image: Generate images from text prompts without input images. Create 1-4 variations per request.
- Multi-Input Mode: Merge multiple input images into a single output using advanced prompt instructions.
- Cost Estimation: Real-time cost calculation based on image size, count, and selected model tier.
- Usage Analytics: Track token usage and estimated spend over time using rich dashboard charts, filtering by session, models, or specific time ranges.
- Model Selection: Choose between Nano Banana 2 (fastest), Nano Banana (stable), or Nano Banana Pro (highest quality) in Settings.
- Inspector Panel:
- Fine-tune aspect ratios including panoramic (4:1, 8:1) and vertical (1:4, 1:8) formats.
- Select output resolution (512, 1K, 2K, 4K).
- Toggle Batch Tier for 50% cost savings on non-urgent jobs.
- Prompt Library: Save and reuse your most effective prompt templates.
- History Tracking: Comprehensive log of all jobs with parameters, costs, and status. Resumable workflows from history.
- Project Gallery: Organize work into distinct projects with isolated output directories.
- Auto-Saving: Active batches and application state are automatically preserved.
- Language: Swift 6.0
- UI Framework: SwiftUI
- Concurrency: Swift Async/Await, Actors, TaskGroups
- Architecture: MVVM with Observation framework (@Observable)
- Persistence: Directory-based storage + JSON state management
- macOS 14.0 (Sonoma) or later
- Xcode 15.0+ (for building from source)
- A Google Cloud Project with Vertex AI / Gemini API access
| Model | Display Name | Best For |
|---|---|---|
gemini-3.1-flash-image-preview |
Nano Banana 2 | Speed, high-volume workflows (default) |
gemini-3-pro-image-preview |
Nano Banana Pro | Complex, multi-turn image editing |
The easiest way to install Nano Banana Helper is to download the compiled version:
- Go to the Releases section on the right sidebar of this GitHub repository.
- Download the latest
Nano Banana Helper.dmgfile. - Open the
.dmgand drag the app into your Applications folder.
-
Clone the repository
git clone https://github.com/joshmac007/Nano-Banana-Helper.git cd Nano-Banana-Helper -
Open in Xcode Double-click
Nano Banana Helper.xcodeprojor run:xed . -
Build and Run Select "Nano Banana Helper" scheme and target "My Mac". Press
Cmd+Rto build and run.
- Setup API Key: On first launch, go to Settings (
Cmd+,) and enter your Gemini API Key. - Select Model (optional): In Settings, choose your preferred image generation model.
- Create a Project: Use the "+" button in the gallery to start a new workspace.
- Stage Images: Drag images onto the "Drop Zone" in the Workbench.
- Configure:
- Enter your prompt in the Inspector.
- Choose your desired resolution and aspect ratio.
- Enable "Batch Tier" if speed is not critical to save costs.
- Execute: Click Start Batch. Monitor progress in the "Results" tab.
- Select Text Mode: Click "Text" in the Inspector header mode toggle.
- Configure:
- Enter your prompt in the Inspector (be descriptive about style, mood, composition).
- Set the number of variations (1-4 images).
- Choose resolution and aspect ratio.
- Execute: Click Generate Images. Monitor progress in the "Results" tab.
Contributions are welcome! Please see CONTRIBUTING.md for details.
- Fork the project.
- Create your feature branch (
git checkout -b feature/AmazingFeature). - Commit your changes (
git commit -m 'Add some AmazingFeature'). - Push to the branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
Distributed under the MIT License. See LICENSE for more information.