PlanMyPlate

AI-powered weekly meal planner. Enter your body stats, dietary preferences, and budget — get a personalised 7-day meal plan, grocery list, and recipe steps.

Stack

• Frontend: React + TypeScript + Vite + Tailwind
• Backend: FastAPI (Python)
• AI: Groq API (free tier — Llama 3.3 70B)

Setup

1. Get a free Groq API key

Sign up at console.groq.com → API Keys → Create key. It's free, no credit card needed.

2. Clone and configure

git clone <your-repo-url>
cd hackathon

Create the backend env file:

cp backend/.env.example backend/.env
# Open backend/.env and paste your Groq API key

3. Run the backend

cd backend
pip install -r requirements.txt
uvicorn main:app --reload

Backend runs at http://localhost:8000.

4. Run the frontend

Open a second terminal:

cd frontend
npm install
npm run dev

Frontend runs at http://localhost:5173. Open that in your browser.

Project structure

backend/
  main.py              # FastAPI routes
  models.py            # Pydantic schemas
  agents/
    body_analysis.py   # BMR / TDEE calculation (no API call)
    macros.py          # Macro targets (no API call)
    meal_planner.py    # 7-day meal plan via Groq
    grocery.py         # Grocery list via Groq
    recipe_steps.py    # Step-by-step recipes via Groq
    update_handler.py  # Natural language plan updates via Groq

frontend/
  src/
    screens/           # Page-level components
    lib/api.ts         # All backend calls
    lib/store.ts       # App state

API endpoints

Method	Path	Description
GET	/health	Health check
POST	/api/analyze	Body analysis + macros
POST	/api/meal-plan	Generate 7-day meal plan
POST	/api/grocery-list	Generate grocery list
POST	/api/recipe-steps	Step-by-step recipe
POST	/api/update-plan	Natural language plan update
POST	/api/full-plan	All of the above in one call