README.md

---
title: Meal Scan
emoji: 🥗
colorFrom: green
colorTo: blue
sdk: streamlit
sdk_version: 1.40.0
app_file: app.py
pinned: false
---

# Meal Scan — Macronutrient Estimator

Upload a meal photo and get an estimated calorie / protein / fat / carb
breakdown. A YOLO model segments the plate into meat, rice, and vegetables;
optional Gemini Vision refines the food identification and the USDA FoodData
Central database supplies nutrition facts.

## Configuration (set these in the Space's "Settings → Secrets")

| Secret | Purpose |
| --- | --- |
| `WEIGHTS_REPO_ID` | Hugging Face model repo holding `best.pt` (e.g. `your-username/meal-scan-weights`) |
| `GEMINI_API_KEY`  | Optional. Enables Gemini food identification. |
| `FDC_API_KEY`     | Optional. Enables live USDA nutrition lookup. |

If the Gemini or USDA keys are absent, the app falls back to generic food
labels and a bundled sample macro table, so it still runs.