NutriAI - AI Nutrition Advisor

NutriAI is an intelligent nutrition assistant that helps you track your diet by simply scanning your food. Powered by Google's Gemini AI, it analyzes food images to provide instant nutritional breakdowns, health scores, and personalized insights.

🚀 Features

• AI Food Scanner: Snap a photo or upload an image to get an instant analysis of your meal.
• USDA-Based Identification: Every food item is matched to a specific USDA FoodData Central entry with FDC ID for accuracy.
• Visual Portion Detection: AI determines portion size based on what's visible in the image (whole item, single serving, or multiple units).
• Deterministic Analysis: Same food image produces consistent, repeatable results every time.
• Detailed Nutrition Facts: Get calorie counts, macronutrients (Protein, Carbs, Fats), fiber, sodium, and key micronutrients.
• WHO/DGA Health Scoring: Health score (0-100) based on WHO Healthy Diet Guidelines and Dietary Guidelines for Americans.
• Smart Context: Add your own notes (e.g., "extra cheese", "cooked in olive oil") to refine the AI's analysis.
• Transparency: See the AI's confidence level, USDA item selection rationale, and portion assumptions.
• About Us Page: Learn more about our mission, story, and core values.
• User-Friendly Navigation: Easy-to-use interface with a "Back to Top" button for smooth scrolling.
• Responsive Design: A modern, mobile-friendly UI built with React and Tailwind CSS.

🔬 Science & Data

NutriAI's analysis is grounded in authoritative scientific sources to ensure accuracy and reliability:

1. USDA FoodData Central: Our primary source for standardized calorie, macronutrient, and micronutrient values. Every food item is matched to a specific USDA FDC ID for traceability.
2. WHO Healthy Diet Guidelines: Used to calculate the Health Score (0-100), evaluating meals based on limits for sugar, salt, and saturated fats.
3. Dietary Guidelines for Americans 2020-2025: Provides the framework for our overall dietary quality assessments and balance recommendations.

AI Capabilities

• Deterministic Behavior: Same image produces identical results for consistency
• Visual Portion Detection: Determines serving size based on image content (whole item, single serving, or counted units)
• Transparency: Provides confidence scores, USDA item selection rationale, and portion assumptions

🛠️ Tech Stack

Frontend

• React: UI library for building the interface.
• Vite: Fast build tool and development server.
• Tailwind CSS: Utility-first CSS framework for styling.
• Shadcn UI: Reusable UI components.
• Framer Motion: For smooth animations and transitions.
• React Router: For client-side routing.

Backend

• Node.js & Express: Server-side runtime and framework.
• Google Gemini API: Advanced AI model for image analysis.
• Dotenv: For environment variable management.

📦 Installation & Setup

Prerequisites

• Node.js (v18 or higher)
• npm (Node Package Manager)

1. Clone the Repository

git clone <YOUR_GIT_URL>
cd clarity-bite

2. Install Dependencies

npm install

4. Run the Application

You need to run both the frontend and the backend servers.

Start the Backend Server:

npm run server

Start the Frontend Development Server:

npm run dev

The app will be available at http://localhost:8080 (or the port shown in your terminal)

📖 Usage

1. Open the application in your browser.
2. Click on "Try AI Food Scanner" or navigate to the Scan page.
3. Upload a photo of your food.
4. (Optional) Add any hidden details in the "Additional Context" box.
5. Click "Analyze Food".
6. View your nutritional breakdown and health score!

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License.