🍳 MealMatch – Smart Recipe Recommender with Multi-Agent System

MealMatch is an intelligent web application that suggests recipes based on the ingredients you already have at home. It leverages a multi-agent architecture using MESA and integrates with the Spoonacular API to retrieve real-world recipes.

🌐 Features

• Input ingredients in various languages (e.g., Romanian, Italian)
• Automatic translation & simplification using googletrans ( translation_agent.py )
• Ingredient validation using a dedicated agent ( ingredient_agent.py )
• Live recipe search from Spoonacular API ( recipe_agent.py )
• Paginated recipe results with images and missing item list ( user_agent.py )
• Agent-based modular architecture with logging and monitoring ( monitor_agent.py )

🧠 Architecture

This project is implemented using the MESA framework (Python-based agent simulation library). It features several specialized agents:

• IngredientInputAgent – Captures raw input from the user
• TranslationAgent – Translates and simplifies ingredients
• IngredientRecognitionAgent – Normalizes and validates ingredient names
• RecipeSuggestionAgent – Queries Spoonacular API for recipe suggestions
• ShoppingAgent – Builds a list of missing ingredients
• UserInteractionAgent – Sends recipe results to the user interface
• MonitoringAgent – Logs system actions and flow state

Agents are scheduled using SimultaneousActivation for proper coordination.

📺 Demo Video

🖼️ Screenshots

Form from /home where user give input

Result page and log

🚀 How to Run

1. Clone the repository

git clone https://github.com/hurr13ane/MealMatch.git
cd MealMatch

Requirements

mesa==1.1.1
python-dotenv
requests>=2.31.0
googletrans==4.0.0-rc1
Flask

To install the required packages, run the following command:

pip install -r requirements.txt

Run the Flask application

python flask_app.py

Contributors ✨

Diana-Maria Iercosan

Alexandru Becher

Support

For any questions or support, please contact us ^^ .

License

This project is licensed under the MIT License. This project was created for educational purposes.