# wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients architecture

> Architecture diagram of the GitHub repository wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients
- Repository: https://github.com/wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients

## Overview

##### Project type and purpose
- This is a data-science–driven recommendation system (recipe recommender) implemented as a Jupyter Notebook.
- Purpose: take a list of ingredients from the user, compute TF-IDF vectors over recipe titles/ingredients/steps, apply cosine similarity, and return ranked Pakistani/Indian dishes.

##### File structure
- Top level:
– “Pakistani Dishes Recipe Recommendation System by Ingredients.ipynb” (core code)
– “README.md” (project description)
- README mentions a data folder (“data/Pakistani_Dishes_Enhanced.xlsx”) even though it’s not in the file tree—this is the primary dataset.
- No explicit web service or frontend directories exist; the project lives in a notebook environment.

##### README for additional insights
- Model: TF-IDF vectorization + cosine similarity
- Weighted similarity across multiple fields (title, ingredients, steps)
- Dependencies: pandas, scikit-learn, numpy, openpyxl

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Interface and Environment
    UI["Jupyter Notebook UI"]:::ui
    Env["Environment & Dependencies\n(pandas, scikit-learn,\nnumpy, openpyxl)"]:::env

    %% Data Storage
    Data[("Raw Dataset\ndata/Pakistani_Dishes_Enhanced.xlsx")]:::storage

    %% Recommendation Pipeline
    subgraph "Recommendation Pipeline"
        direction TB
        Input["Input Handler\n(parse ingredients)"]:::process
        Pre["Preprocessing Module\n(tokenization, normalization,\nfield weighting)"]:::process
        Feature["Feature Extraction Module\n(TF-IDF Vectorizer)"]:::process
        Sim["Similarity Engine\n(cosine similarity & ranking)"]:::process
        Output["Output Renderer\n(display top-N recipes)"]:::ui
    end

    %% Data Flow
    UI -->|enter ingredients| Input
    Input --> Pre
    Pre --> Feature
    Feature --> Sim
    Sim --> Output
    Output -->|show recommendations| UI

    Pre -->|load raw data| Data
    Env -.-> Pre
    Env -.-> Feature
    Env -.-> Sim

    %% Click Events
    click UI "https://github.com/wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients/blob/main/Pakistani Dishes Recipe Recommendation System by Ingredients.ipynb"
    click Input "https://github.com/wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients/blob/main/Pakistani Dishes Recipe Recommendation System by Ingredients.ipynb"
    click Pre "https://github.com/wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients/blob/main/Pakistani Dishes Recipe Recommendation System by Ingredients.ipynb"
    click Feature "https://github.com/wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients/blob/main/Pakistani Dishes Recipe Recommendation System by Ingredients.ipynb"
    click Sim "https://github.com/wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients/blob/main/Pakistani Dishes Recipe Recommendation System by Ingredients.ipynb"
    click Output "https://github.com/wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients/blob/main/Pakistani Dishes Recipe Recommendation System by Ingredients.ipynb"
    click Data "https://github.com/wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients/blob/main/data/Pakistani_Dishes_Enhanced.xlsx"
    click Env "https://github.com/wkgit0/-pakistani-indian-dishes-recipe-recommendation-system-by-ingredients/blob/main/README.md"

    %% Styles
    classDef ui fill:#FFD966,stroke:#BF9000,color:#000000;
    classDef process fill:#9FC5E8,stroke:#1155CC,color:#000000;
    classDef storage fill:#93C47D,stroke:#38761D,color:#000000,stroke-dasharray: 5 5;
    classDef env fill:#F4B183,stroke:#E06666,color:#000000,stroke-dasharray: 2 2;
```
