Skip to content

Dev-in-the-BM/Fluid-ID

Repository files navigation

Banner|690x344

Fluid ID 🌙✨

Fluid ID is an AI-powered application designed to transform your photos into amazing, new scenes and characters with a single click. Upload a picture of a person, choose some fun options, and let the AI instantly remix your image!


What It Does

This app is a creative playground for your photos, turning a standard portrait into something hilarious and unexpected.

  • Image Transformation: Easily upload a photo of a person and transform them into scenes like a pirate, an astronaut, a superhero, and more.
  • Easy Prompting: Use the Prompt Builder to choose from simple categories like role, action, emotion, and clothes to build your creative prompt.
  • Smart Suggestions: The app provides dynamic prompt suggestions (like "Astronaut," "singer," "dancing," or "wearing glasses") that change based on what you've already selected, making the process intuitive and fun.

How to Get Started

This project contains everything you need to run the application locally.

Prerequisites: You need Node.js installed on your machine.

  1. Install dependencies:

    npm install
  2. Set the API Key: You need a Gemini API Key to run the app. Create a file named .env.local in the root directory and add your key:

    .env.local

    GEMINI_API_KEY="YOUR_API_KEY_HERE"
    
  3. Run the app:

    npm run dev

    The app will start and be available in your web browser, typically at http://localhost:3000.


Under the Hood

The Fluid ID app is a React and TypeScript project that leverages Google's Gemini models for its functionality:

  • Image Transformation: It uses the gemini-2.5-flash-image model. The prompt specifically requests the model to transform the image while maintaining the person's facial features.
  • Contextual Prompts: A separate model call generates the creative suggestions for the prompt builder in real-time, providing an interactive experience.

About

Nano Banana powered image remixer

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published