Summary

This repository serves as the official starter kit and resource hub for the Nano Banana 48 Hour Challenge, hosted by Google DeepMind. It equips participants with everything needed to build applications using Gemini 2.5 Flash Image Preview, a state-of-the-art image model. The kit aims to accelerate development for hackers and developers, enabling them to create innovative visual interaction experiences and compete for significant prizes.

How It Works

The core of the kit is Gemini 2.5 Flash Image Preview (Nano Banana), a model designed for dynamic creation through text prompts. It allows users to generate and edit images, blend realities, and access Gemini's world knowledge. This approach enables novel applications that transform how users interact with visuals, focusing on areas like dynamic storytelling, e-commerce visualization, automated creative workflows, and advanced photo editing.

Quick Start & Requirements

• Installation: Clone the repository. Obtain a free Gemini API key via the provided API Key Guide.
• Prerequisites: Gemini API key, Python, JavaScript (examples available).
• Resources: Official Gemini API Docs: https://ai.google.dev/gemini-api/docs/image-generation, Prompting Guide & Strategies: https://ai.google.dev/gemini-api/docs/image-generation#prompt-guide. Kaggle Competition Page: https://www.kaggle.com/competitions/banana.
• Setup: Designed for rapid setup within a 48-hour hackathon timeframe.

Highlighted Details

• Event: Official starter kit for the Nano Banana 48 Hour Challenge (September 6-7, 2025).
• Partnerships: Collaborates with Fal and ElevenLabs to enhance project capabilities.
• Prizes: Offers over $400,000 in prizes for participants.
• Submission: Projects are judged on video demos, public links, and Gemini integration, with emphasis on innovation, technical execution, and presentation.
• API Usage: A special tier provides 500 free requests per project per day.

Maintenance & Community

• Community Support: All questions, team formation, and discussions are hosted on the official Kaggle platform.

Licensing & Compatibility

• License: Not specified in the provided README.
• Compatibility: Designed for hackathon use, implying compatibility with standard development environments.

Limitations & Caveats

• API Limits: Free tier access is restricted to 500 requests per project daily.
• Model Status: Gemini 2.5 Flash Image Preview is in "Image Preview" status, indicating it may be experimental.
• Event-Specific: The kit is tailored for a specific 48-hour hackathon event, potentially limiting its long-term applicability outside this context.
• Partner Dependencies: Functionality may rely on external partner APIs (Fal, ElevenLabs), which could have their own usage terms.