Skip to content

SmartChef: Your personal kitchen assistant. Track ingredients, manage inventory, and discover recipes based on what you have in stock.

Notifications You must be signed in to change notification settings

DEM-YU/SmartChef

Repository files navigation

👨‍🍳 SmartChef 4.0 Pro: Intelligent Fridge Manager

SmartChef is a Python-based intelligent recipe matching application built with Streamlit. It solves the "what should I cook?" dilemma by matching ingredients in your fridge with a database of 100+ recipes using a weighted scoring algorithm.


🌟 Key Features

  • Weighted Matching Algorithm: Categorizes ingredients into "Main" and "Side" to prioritize core proteins and vegetables.
  • Core Missing Penalty: Automatically penalizes recipes missing essential main ingredients, ensuring realistic cooking suggestions.
  • Automated Categorization: Scans the database to group ingredients into Meat, Veggies, Seafood, etc., for easy selection.
  • Pantry Staple Filtering: Intelligently ignores seasonings (salt, oil, pepper) and tools (toothpicks) in the selection process to reduce clutter.
  • Dynamic Visuals: Real-time progress bars and color-coded status (Green/Orange/Red) based on matching accuracy.

📂 Project Structure

  • app.py: UI rendering and sidebar categorization.
  • logic.py: Core logic including the matching algorithm and pantry filters.
  • recipes.json: Structured database containing recipe metadata.
  • requirements.txt: Minimal dependencies for easy deployment.

🚀 Quick Start

  1. Install Dependencies:
    pip install streamlit
  2. Run Application:
    streamlit run app.py

Developer: Brooks (Computer Science, University of Alberta) Location: Edmonton, Alberta, Canada Last Updated: Dec 21, 2025, 06:20 AM MST

About

SmartChef: Your personal kitchen assistant. Track ingredients, manage inventory, and discover recipes based on what you have in stock.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages