Skip to content

itsjayeshk/smart-pantry

Repository files navigation

🧠 Smart Pantry & AI-Based Recipe Recommendation System

🚀 Live Demo: https://smart-pantry-hcrj.onrender.com


📌 Overview

Smart Pantry is a full-stack web application designed to help users efficiently manage their groceries, reduce food waste, and get intelligent recipe recommendations.

It allows users to:

  • Track pantry items and expiry dates
  • Get AI-powered recipe suggestions based on available ingredients
  • Analyze usage patterns
  • Optimize grocery planning

✨ Features

🥫 Pantry Management

  • Add, update, and delete pantry items
  • Track quantities and expiry dates
  • Organized dashboard view

🍳 AI Recipe Recommendations

  • Suggest recipes based on available ingredients
  • Fallback deterministic recipes if AI key not provided
  • Smart ingredient matching system

📊 Analytics Dashboard

  • Pantry usage insights
  • Ingredient trends
  • Data visualization using charts

🔐 Authentication System

  • Secure user signup & login
  • JWT-based authentication

☁️ Cloud Integration

  • MongoDB Atlas (cloud database)
  • Deployed on Render

🏗️ Tech Stack

Backend

  • Python (Flask)
  • MongoDB (PyMongo)
  • JWT Authentication

Frontend

  • HTML, CSS, JavaScript
  • Tailwind CSS
  • Chart.js

Deployment

  • Render (Web Service)
  • MongoDB Atlas (Database)

⚙️ Project Structure

smart-pantry/
│
├── app.py
├── config.py
├── requirements.txt
├── runtime.txt
│
├── database/
├── models/
├── routes/
├── services/
│
├── templates/
├── static/
│
└── datasets/

🔑 Environment Variables

Create a .env file locally:

MONGO_URI=your_mongodb_uri
MONGO_DB_NAME=smart_pantry
SECRET_KEY=your_secret
JWT_SECRET_KEY=your_jwt_secret
OPENAI_API_KEY=your_key (optional)

🚀 Local Setup

1. Clone Repository

git clone https://github.com/itsjayeshk/smart-pantry.git
cd smart-pantry

2. Install Dependencies

pip install -r requirements.txt

3. Run App

python app.py

4. Open in Browser

http://127.0.0.1:5000

📡 API Endpoints

Auth

  • POST /auth/signup
  • POST /auth/login

Pantry

  • POST /pantry/add
  • GET /pantry/items

Recipes

  • GET /recommendations

Analytics

  • GET /analytics

🧪 Example Request

POST /auth/signup

{
  "email": "test@example.com",
  "password": "123456"
}

🎯 Future Improvements

  • 🔔 Expiry notifications
  • 🛒 Auto grocery list generation
  • 📅 Weekly meal planning
  • 🧠 Advanced AI recommendations
  • 📷 Image-based ingredient detection

📸 Screenshots

(Add your screenshots here)


👨‍💻 Author

Jayesh Khandelwal GitHub: https://github.com/itsjayeshk


⭐ Acknowledgements

  • Flask Documentation
  • MongoDB Atlas
  • Render Deployment Platform

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors