nanobanana-skill

Generate or edit images via Google Gemini API with configurable sizes and resolutions.

1.6k|244|Updated Jul 18, 2025
One-click install
npx skills add https://github.com/feiskyer/claude-code-settings --skill nanobanana-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nanobanana-skill
Source: https://github.com/feiskyer/claude-code-settings/tree/main/plugins/nanobanana-skill/skills/nanobanana-skill
Command: npx skills add https://github.com/feiskyer/claude-code-settings --skill nanobanana-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-dotenv, httpx[socks], google-genai, Pillow, and includes scripts (resource) components.

What problem does it solve?

This Skill simplifies image creation and modification, eliminating the need for complex graphic design software or manual editing, allowing you to quickly visualize ideas.

Core Features & Use Cases

  • AI Image Generation: Create images from text prompts with various aspect ratios (e.g., square, landscape) and resolutions (1K, 2K, 4K).
  • Image Editing: Modify existing images based on natural language instructions, making quick adjustments effortless.
  • Model Flexibility: Choose between gemini-3-pro-image-preview for higher quality or gemini-2.5-flash-image for faster generation.
  • Use Case: Generate a square, 2K resolution logo for a tech startup with a minimalist design, and save it as 'tech-logo.png'.

Quick Start

Use the nanobanana-skill to generate a serene mountain landscape at sunset with a lake.

Frequently Asked Questions about nanobanana-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate images from text prompts using AI?

Image generation from text prompts uses AI models to create visuals based on natural language descriptions. This Skill leverages Google Gemini API to generate images in multiple aspect ratios and resolutions—square, landscape, or ultra-wide—by sending your prompt and configuration options to the model, which returns a ready-to-save image file.

Can I edit existing images with natural language instructions?

Yes, image editing with natural language instructions allows you to modify existing images by describing the changes you want. This Skill accepts an image file and edit prompt, sends both to Gemini API, and returns an edited version without requiring manual design software.

What image formats and resolutions does Gemini API support?

Gemini API supports multiple aspect ratios—portrait, landscape, and ultra-wide—with resolution options including 1K, 2K, and 4K. This Skill lets you specify --size and --resolution flags to control output dimensions and quality before generation or editing.

Do I need to choose between different Gemini image models?

Yes, this Skill supports model selection via the --model flag: gemini-3-pro-image-preview prioritizes higher quality output, while gemini-2.5-flash-image prioritizes faster generation. Choose based on whether quality or speed matters more for your workflow.

What setup is required to use Gemini for image generation?

To use Gemini image generation, you need a valid GEMINI_API_KEY, Python 3 with installed dependencies (google-genai, Pillow, python-dotenv, httpx[socks]), and the nanobanana.py executable. Store your API key in a .env file and ensure all packages are installed before running.

Can this Skill generate and save images in batch or scripted workflows?

Yes, this Skill is designed for scripted image generation and editing. It accepts command-line options (--size, --model, --resolution) and saves output as image files, making it suitable for automation, batch processing, or integration into larger creative pipelines.