MealMateAI

Project as part of the course "Workshop on developing scalable AI systems"

MealMateAI

MealMateAI is your friendly kitchen companion: it learns your preferences & pantry inventory, then generates personalized meal plans, recipe suggestions, and consolidated shopping lists.
It aims to make cooking approachable, reduce food waste, and promote healthier eating habits.

📁 Project Structure

MealMateAI/
├── api-gateway/                 # Express.js gateway: auth & routing
├── services/
│   ├── user-service/            # Flask microservice: user auth & pantry CRUD
│   ├── recipe-service/          # Flask microservice: recipe CRUD & search
│   ├── meal-planner-service/    # Flask microservice: weekly menu generation
│   └── notification-service/    # Flask microservice: email reminders
├── frontend/                    # React application (UI)
├── scripts/                     # Helper scripts (e.g. init-db.sh)
├── docker-compose.yml           # Orchestrates all containers
├── .env.example                 # Template for environment variables
└── README.md                    # This file

## ⚙️ Setup

## 🐳 Running with Docker

1. **Build & start all services (attached)**  
   ```bash
   docker-compose up --build

2. Build & start all services (detached)

   docker-compose up -d --build

3. View logs

   docker-compose logs -f

4. Stop & remove containers, networks, and volumes

   docker-compose down

5. Rebuild a single service

   docker-compose build <service-name>