Snap and Seek

I built this app first to explore image recognition in OpenAI's GPT-4 model through developing a fun web application that keeps us engaged with our real world and improves vocabulary and the ability to describe things in kids.

What is it — Snap and Seek is a single-player, image-based riddle game. Upload a photo, get AI-generated riddles about objects in the image, and guess with temperature feedback (cold → warm → hot → bullseye) across 3 rounds.

Tech at a glance

Layer	Stack
Frontend	React, Vite, Tailwind CSS, TypeScript
Backend	FastAPI, OpenAI GPT-4 Vision

Quick start

1. Clone the repo.
2. Server: cd server, create a venv, pip install -r requirements.txt, add .env with OPENAI_KEY, then uvicorn main:app --reload --host 0.0.0.0 --port 8000.
3. Client: cd client, npm install, optionally set VITE_BASE_URL in .env, then npm run dev.

Web App in the Wild

Preview	Warm	Bullseye

See client/README.md and server/README.md for full setup and env details.

Project layout

• client/ — React frontend
• server/ — FastAPI backend
• prd/ — Product and design docs

License — See LICENSE.