README.md

---

title: AI Diet Planner & Nutrition Assistant
emoji: 🍽️
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit
short_description: AI-powered diet planning with nutrition analysis
---


# 🍽️ AI Diet Planner & Nutrition Assistant

An intelligent diet planning application that uses RAG (Retrieval-Augmented Generation) technology to provide personalized nutrition advice, meal planning, and dietary recommendations.

## ✨ Features

### 🎯 **Personalized Diet Planning**
- **Weekly Meal Plans**: Complete 7-day diet plans with detailed meal breakdowns
- **Daily Nutrition**: Individual day meal planning with macro and micronutrient analysis
- **Customizable Parameters**: Age, weight, height, activity level, and dietary preferences

### 📊 **Nutrition Analysis**
- **Comprehensive Nutrition Facts**: Detailed breakdown of calories, macronutrients, vitamins, and minerals
- **USDA Food Database**: Access to extensive food nutrition information
- **BMR & TDEE Calculations**: Accurate metabolic rate calculations using Mifflin-St Jeor formula

### 🤖 **AI-Powered Recommendations**
- **Smart Suggestions**: Personalized dietary recommendations based on your profile
- **Goal-Oriented Planning**: Weight loss, muscle gain, or maintenance-focused plans
- **Interactive Chat**: Natural language interface for easy interaction

### 📋 **Advanced Features**
- **JSON Export**: All plans and analyses saved as structured JSON files
- **Table Formatting**: Beautiful markdown tables for easy reading
- **Multi-language Support**: English interface with comprehensive food database

## 🚀 How to Use

### 1. **Create a Diet Plan**
```

"Create a weekly diet plan for a 25-year-old male, 70kg, 175cm, moderate activity"

```

### 2. **Calculate Nutrition**
```

"Calculate nutrition for 200g chicken breast and 150g rice"

```

### 3. **Get Recommendations**
```

"Get diet recommendations for weight loss"

```

### 4. **Vegetarian Options**
```

"Create a vegetarian meal plan for 7 days"

```

## 🔧 Technical Details

### **Architecture**
- **RAG System**: Retrieval-Augmented Generation for intelligent responses
- **Groq API**: Fast LLM inference for real-time responses
- **Sentence Transformers**: Semantic search for relevant nutrition data
- **Gradio**: Modern web interface for easy interaction

### **Data Sources**
- **USDA FoodData Central**: Comprehensive nutrition database
- **Custom Food Database**: Curated collection of common foods
- **Nutritional Algorithms**: BMR, TDEE, and macro distribution calculations

### **Output Formats**
- **JSON Files**: Structured data for all plans and analyses
- **Markdown Tables**: Human-readable formatted output
- **Interactive Chat**: Real-time conversation interface

## 📁 File Structure

```

├── app.py                 # Main Gradio application

├── main3.py              # RAG system and tool router

├── diet_tool.py          # Diet planning algorithms

├── usda_provider.py      # USDA API integration

├── requirements.txt      # Python dependencies

├── README.md            # This file

└── outputs/             # Generated JSON files

    ├── diet_plan_weekly_*.json

    ├── diet_plan_daily_*.json

    └── diet_recommendations_*.json

```

## 🛠️ Setup Instructions

### **For Hugging Face Spaces**

1. **Create a new Space** on Hugging Face
2. **Upload all files** to your Space repository
3. **Set Environment Variables**:
   - Go to Settings → Secrets
   - Add `GROQ_API_KEY` with your Groq API key
4. **Deploy** - The Space will automatically build and deploy

### **For Local Development**

1. **Install Dependencies**:
   ```bash

   pip install -r requirements.txt

   ```

2. **Set Environment Variable**:
   ```bash

   export GROQ_API_KEY="your_groq_api_key_here"

   ```

3. **Run the Application**:
   ```bash

   python app.py

   ```

## 🔑 API Keys Required

- **Groq API Key**: Get your free API key from [console.groq.com](https://console.groq.com)

## 📊 Example Outputs

### **Weekly Diet Plan**
- 7-day meal breakdown
- Daily calorie and macro targets
- Detailed food lists with portions
- Nutritional analysis per meal

### **Nutrition Analysis**
- Complete macronutrient breakdown
- Vitamin and mineral content
- Calorie calculations
- Serving size recommendations

### **Dietary Recommendations**
- Personalized advice based on profile
- Goal-specific suggestions
- Macro distribution guidance
- Lifestyle integration tips

## 🤝 Contributing

Feel free to contribute to this project by:
- Adding new food items to the database
- Improving nutrition calculation algorithms
- Enhancing the user interface
- Adding new dietary patterns (keto, paleo, etc.)

## 📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

## 🙏 Acknowledgments

- **USDA FoodData Central** for comprehensive nutrition data
- **Groq** for fast LLM inference
- **Gradio** for the beautiful web interface
- **Sentence Transformers** for semantic search capabilities

---

**Made with ❤️ for better nutrition and healthier living!**