Budget Spree

An AI-powered shopping recommender that suggests products based on your budget, category, and priorities — built with Next.js and Claude.

What It Does

• Single Item mode — pick a category, set your budget, and get 5 product recommendations from retailers like Amazon, Walmart, Best Buy, and more.
• Full Setup mode — get a complete curated set of items for an entire setup (e.g. a full gaming PC build or home gym) all within your total budget.

Tech Stack

• Next.js 16 (App Router)
• React 19
• Tailwind CSS 4
• Anthropic Claude API (claude-opus-4-6)

Getting Started

Prerequisites

• Node.js 18+
• An Anthropic API key

Installation

1. Clone the repo:

   git clone https://github.com/KeysToRealities/Hackathon.git
   cd Hackathon/budget-recommender

2. Install dependencies:

   npm install

3. Create a .env.local file in the budget-recommender folder and add your Anthropic API key:

   ANTHROPIC_API_KEY=your_api_key_here
   

4. Start the development server:

   npm run dev

5. Open http://localhost:3000 in your browser.

How to Use

1. Choose a mode — Single Item for one product, Full Setup for a complete build.
2. Select a category — Electronics, Clothing, Fitness, Gaming, or Home & Kitchen.
3. Pick your budget — from Under $50 up to $500+.
4. Set your priority — Best Value, Top Rated, Premium Quality, or Budget Pick.
5. Add optional details — e.g. "wireless", "blue color", "for beginners".
6. Click Get Recommendations (or Build My Setup) and Claude will suggest products for you.
7. Click Search on Amazon on any card to find and buy that item.

Environment Variables

Variable	Description
ANTHROPIC_API_KEY	Your Anthropic API key — required for recommendations to work