# Smart Recipe Recommender
🍽 **Smart Recipe Recommender** is a project developed by **Rebira Adugna** during the **Vibe Coding 3.0 Hackathon**, organized by **PLP (Power Learn Project)**.
This project allows users to generate **personalized recipes** based on the ingredients they have in their pantry. Users can also save favorites, view food news, and listen to recipe instructions via text-to-speech.
---
## **Features**
- User registration & login with secure password hashing
- Personal pantry management
- Recipe generation based on ingredients
- Text-to-speech for recipes
- Save favorite recipes
- Food news ticker
- Responsive design for mobile and desktop
---
## **Technologies Used**
- Python 3 & Flask
- SQLite (lightweight database)
- HTML, CSS, JavaScript
- Flask-Login for user authentication
- Fetch API for async requests
---
## **Setup / Installation**
1. Clone this repository:
```bash
git clone https://github.com/Rebira678/SmartRecipeRecommender
cd smart-recipe
```-
Create a virtual environment:
python -m venv venv source venv/bin/activate # macOS/Linux venv\Scripts\activate # Windows
-
Install dependencies:
pip install -r requirements.txt
-
Run the app:
python app.py
-
Open
http://127.0.0.1:5000in your browser.
- Register a new account
- Add ingredients to your pantry
- Click Generate to see recipe suggestions
- Save favorites or listen to instructions
- Check food news
(https://smartreciperecommender-c8i8.onrender.com/)
Click the thumbnail above to watch the demo on YouTube.
Rebira Adugna