Skip to content

GiftGenius

GiftGenius solves holiday gift-giving stress by turning a simple text description into a beautiful, personalized gift guide.

Code Video Cerebral Valley

Core trick

Gemini generates gift picks from recipient details, then Nano Banana Pro renders them as a 2K magazine-style guide image.

Tags

productivitycreative/music

Description

GiftGenius solves holiday gift-giving stress by turning a simple text description into a beautiful, personalized gift guide. Users describe the recipient (age, interests, hobbies, budget) and get a high-resolution visual guide with 3-5 tailored gift recommendations, each w/ pricing and personalized reasoning. It's shareable, printable, and perfect for the time-crunched holiday season.
warrenjfeng/gift-genius★ 00 forksJavaScriptMITCreated Dec 6, 2025 · last push Dec 7, 2025

README excerpt

# GiftGenius - AI Holiday Gift Guide Generator

A web application that generates personalized holiday gift guides using Google's Gemini 3 and Nano Banana Pro models.

## Features

- **AI-Powered Analysis**: Uses Gemini 3 to analyze recipient details and generate personalized gift recommendations
- **Beautiful Visual Guides**: Renders 2K resolution magazine-style gift guides with Nano Banana Pro
- **Personalized Recommendations**: 6-8 thoughtful gift suggestions based on recipient interests, personality, and budget
- **Modern UI**: Clean, responsive interface that works on desktop and mobile
- **Easy Sharing**: Download and share your generated gift guides

## Tech Stack

- **React** - UI framework
- **Vite** - Build tool and dev server
- **Gemini 3 API** - For analysis and recommendation generation
- **Nano Banana Pro API** - For 2K visual rendering

## Setup

### Prerequisites

- Node.js 16+ and npm/yarn
- API keys for Gemini 3 and Nano Banana Pro

### Installation

1. Clone the repository:
```bash
git clone <repository-url>
cd gift-genius
```

2. Install dependencies:
```bash
npm install
```

3. Configure API keys:
   - Copy `.env.example` to `.env`
   - Add your API keys:
```
VITE_GEMINI_API_KEY=your_gemini_api_key_here
VITE_NANO_BANANA_API_KEY=your_nano_banana_api_key_here
```

### Development

Run the development server:
```bash
npm run dev
```

The app will be available at `http://localhost:5173`

### Build for Production

Build for production:
```bash
npm run build
```

Team