Skip to content

Arvind644/hackathon

Repository files navigation

AI Jewelry Stylist Kiosk 🎭💎

Live Demo: https://hackathon-beryl-iota.vercel.app/

An AI-powered jewelry recommendation system that analyzes user photos and generates personalized jewelry suggestions using advanced computer vision and celebrity style matching.

Goal

Create a responsive virtual try-on web app for Evol Jewels that lets users try jewelry using only sliders and clicks. The app matches the brand’s colors, uses LLMs for background removal and image generation, and includes an easy lead capture step through QR or email for later marketing. Screenshot 2025-10-21 at 11 49 19 AM

Tech StackTech Stack & Frameworks Used:

  1. Frontend Stack: Next.js 15 (App Router) + React 19 + TypeScript + Tailwind CSS 4 for modern, responsive UI with smooth animations
  2. AI Integration: fal.ai client with Nanobanana for face-preserving try-on
  3. Database: Prisma ORM + PostgreSQL for reliable data storage (try-on results, jewelry catalog, user sessions)
  4. Image Processing: React Webcam + Dropzone for seamless photo capture and upload
  5. Kiosk Optimization: Progressive Web App architecture ensures smooth performance on large touchscreens whether 55 inches, or a projector screen
  6. Email Integration: NodeMailer This flexible deployment (kiosk + mobile) maximizes reach across retail locations, trade shows, and online channels.
Screenshot 2025-10-21 at 11 49 32 AM

🚀 5-Step User Journey

  1. Approach: Akhil approaches the kiosk and sees his reflection in the display
  2. Capture: He taps to start, uploads a selfie using the camera, then browses Evol's jewelry collection
  3. Try-On: He selects a diamond necklace and gold earrings - within 8 seconds, he sees himself wearing both pieces with perfect facial preservation
  4. Match: On the side, it shows [Ranveer Singh] in a similar look, displays his vibe & recommends a few more jewelry pieces from Evol's collection & takes him back to step 2
  5. Share: Once he finds an impressive design, he saves the look to his gallery, and scans the QR code to continue shopping on his phone with his personalized recommendations. He can also email/message it to himself
Screenshot 2025-10-21 at 11 49 47 AM

📊 Database Schema

WhatsApp Image 2025-10-15 at 21 31 14

The system uses a PostgreSQL database with two main entities:

  • VirtualTryOn: Stores try-on session results with AI processing metadata
  • JewelryCollection: Manages the jewelry catalog with usage analytics

Dev Instructions:

This is a Next.js project bootstrapped with create-next-app.

Getting Started

Environment Setup

First, you'll need to set up your Fal AI API key:

  1. Create a .env file in the root directory of the project
  2. Add your Fal AI API key:
NEXT_PUBLIC_FAL_KEY=your_fal_ai_api_key_here

To get your Fal AI API key:

  1. Visit Fal AI
  2. Sign up or log in to your account
  3. Navigate to your dashboard to generate an API key
  4. Copy the API key and paste it in your .env file

Running the Development Server

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Learn More

To learn more about Next.js, take a look at the following resources:

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Evol Jewels for providing the jewelry catalog in a very structured dataset
  • Fal AI for the AI image generation capabilities
  • Next.js and Vercel for the amazing development platform

🙏 Hackathon Outcome

EC5BFE0E-15B1-4925-A281-092DE7C2ABE9 Screenshot 2025-11-02 at 2 06 43 PM

Social media post links on this:

  1. [Twitter] - ⁠https://x.com/fueledfountane/status/1983096659610611797
  2. [Linkedin] - ⁠https://www.linkedin.com/feed/update/urn:li:activity:7388863179310804992
  3. [Instagram]- ⁠https://www.instagram.com/p/DQWMcUYj7-s

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •