Welcome, hackers! This repository is the official starter kit and resource hub for the Nano Banana 48 Hour Challenge, hosted by Google DeepMind. Everything you need to get started, build something incredible, and submit your project is right here.
Go Bananas! For 48 hours, starting on September 6, 2025, we are unlocking a special 48-hour free tier of the Gemini API, putting Gemini 2.5 Flash Image Preview (aka Nano Banana), our state-of-the-art image model, into your hands. In collaboration with Fal and ElevenLabs, we're giving over $400,000 of prizes! We're looking forward to seeing what you build in the next two days!
Nano Banana is about dynamic creation. Edit with words, blend realities, and access Gemini's unique world knowledge. We challenge you to unleash this power. Show us an application that transforms how we interact with visuals and deliver something that wasn't possible before.
- 🚀 Get Started in 3 Steps
- 🎯 The Challenge
- 🛠️ Technical Resources
- 🏆 Submission & Judging
- 🗓️ Timeline & Prizes
- 💬 Getting Help & Discussion
-
Get Your Free API Key
- Follow the API Key Guide to create your API key to access Nano Banana on the Gemini API.
-
Explore the Resources
- Clone this repository to access code examples and check out the external links for inspiration and documentation.
-
Submit Your Project on Kaggle
- When you're ready, head over to the Official Kaggle Competition Page to submit your project before the deadline.
Your mission is to build a product, application, or demo that showcases one or more of these core strengths. Think beyond simple text-to-image. How can these advanced features create a magical user experience?
Consider applications that:
- Enhance dynamic storytelling (e.g., consistent character comics).
- Revolutionize e-commerce (e.g., virtual room placement or product visualization).
- Automate creative workflows (e.g., personalized marketing assets at scale).
- Build the next generation of natural language photo editors.
- START HERE: Getting Your API Key: Step-by-step instructions to get your free Gemini API key and generate a first image with nano banana using Python.
- Use Nano banana: Learn of the different ways to use nano banana, to generate and edit images.
examples/: Self-contained code snippets demonstrating specific features of the Gemini API.- 🌐 Official Nano Banana 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
- 🍳 Cookbooks (Advanced Recipes):
- ✨ Inspirational Applets: See what's possible with these interactive demos.
Explore the tools and platforms from our partners to enhance your project.
- Get started with the ElevenLabs API
- Get started with ElevenLabs Agents
- Show us your projects
- Follow for updates on X
- Watch on YouTube
- Create an account at fal.ai
- Generate your API Keys after logging in
- Start building: JavaScript and Python snippets can be found here
Your project will be judged primarily on your video demo. Show, don't just tell! We want to see the "wow" factor, the utility of your application, and the technical skill behind it.
All submissions must be made through the official competition page:
Your complete Kaggle submission must include:
-
🎥 The Video Demo (2 minutes or less)
- An engaging video demonstrating your project. It must be posted publicly (e.g., YouTube, X/Twitter) and viewable without a login.
-
🔗 Public Project Link
- A URL to your working product or interactive demo. If a live demo isn't feasible, a link to your public code repository (e.g., GitHub) with clear setup instructions is required.
-
✍️ Gemini Integration Write-up (max 200 words)
- A brief description detailing which Gemini 2.5 Flash Image features you used and how they are central to your application.
- 💡 Innovation and "Wow" Factor (40%): How creative and novel is the application? Does it leverage Gemini 2.5 Flash Image in a way that wasn't previously possible?
- ⚙️ Technical Execution and Functionality (30%): Does the application work? How effectively does it utilize the API's advanced features (consistency, fusion, editing)?
- 📈 Potential Impact and Utility (20%): Does the application solve a real-world problem (creative, commercial, or educational)?
- 🎬 Presentation Quality (10%): Clarity, storytelling, and engagement of the video demo.
For the Special Technology Prize, these same criteria will be applied with a focus on how that specific technology (ElevenLabs) was pivotal in achieving the project's impact and technical excellence.
Compete for your share of over $400,000 in prizes!
Overall Track
- Top 50 Submissions: $5,000 in Gemini API Credits each + $1,000 in Fal credits, and 11 million (approx. US $2,000) ElevenLabs Credits.
Special Technology Prize - ElevenLabs
- Winner: 22M ElevenLabs Credits (6 months of Scale, Approx value: $4,000)
- Competition Starts: September 6, 2025 (12:01am UTC, September 5, 2025 5:00 PM PT)
- Final Submission Deadline: September 7, 2025 (4:59 PM UTC, 11:59 PM PT)
- Judging Period: September 8 - 17, 2025
- Winners Announced: September 19, 2025 (Estimated)
Time required to evaluate results is dependent on the number of submissions. All deadlines are at 11:59 PM UTC on the corresponding day unless otherwise noted. The organizers reserve the right to update the timeline.
Please note the special tier for the Gemini API (for all API users) - will allow 500 requests per project per day.
Developers using a paid API key will pay for all of their usage. To get the free 500 generations, please use a free tier API key.
All questions, team formation, and discussions will take place on the Kaggle platform. This is the best place to get help from organizers, mentors, and the community.
- Ask a question: Post your technical or general questions for the community and organizers.
- Find teammates: Create a post to look for collaborators.
- Share your ideas: Discuss your project concepts and get feedback.
Happy Hacking!
