# tejas1730/movie-recommandation-ai architecture

> Architecture diagram of the GitHub repository tejas1730/movie-recommandation-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tejas1730/movie-recommandation-ai
- Repository: https://github.com/tejas1730/movie-recommandation-ai

## Overview

##### Project type and purpose
- This is a small-scale, full-stack machine-learning-driven web application (“Movie Recommendation System”).
- It combines a data pipeline and ML model (in a Jupyter notebook) with a lightweight frontend server (Streamlit) to deliver personalized movie recommendations.

##### File structure
- Top-level files:
- app.py – Streamlit app that serves predictions
- movierecommend.ipynb – notebook containing data loading, preprocessing, model training/evaluation
- movies.csv – raw dataset of movie metadata and ratings
- images/ – static assets (movie poster images)
- .gitattributes & README.md – repo metadata and documentation
- No separate “backend” directory, but the notebook is the training pipeline and app.py is the serving component.

##### README for additional insights
- Confirms Python 3.x, pandas, numpy, scikit-learn, Streamlit, Jupyter Notebook
- Describes high-level flow: data → ML algorithm → model → user-facing recommendation
- Mentions use of Git LFS for large artifacts (e.g., trained model pickles)

##### Detail without overthinking
- Every file-backed component (CSV, .ipynb, images folder)
- Clearly distinguish offline training vs. online serving
- How the model artifact bridges those two worlds

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Offline Training Pipeline
    subgraph "Offline Training Pipeline"
        CSV["movies.csv"]:::offline
        Notebook["movierecommend.ipynb\n(Jupyter Notebook)"]:::offline
        Model["model.pkl\n(Serialized Model)"]:::offline
    end
    CSV -->|"load CSV"| Notebook
    Notebook -->|"train & serialize"| Model

    %% Online Serving
    subgraph "Online Serving"
        Browser["User Browser"]:::online
        App["Streamlit App\n(app.py)"]:::online
        Img["Static Assets\n(images/)"]:::static
    end
    Browser -->|"request recommendations"| App
    App -->|"load model.pkl"| Model
    App -->|"serve predictions"| Browser
    App -->|"serve images"| Img

    %% Repository Documentation & Metadata
    subgraph "Repository Docs"
        README["README.md"]:::doc
        GITATTR[".gitattributes"]:::doc
    end

    %% Click Events
    click App "https://github.com/tejas1730/movie-recommandation-ai/blob/main/app.py"
    click CSV "https://github.com/tejas1730/movie-recommandation-ai/blob/main/movies.csv"
    click Notebook "https://github.com/tejas1730/movie-recommandation-ai/blob/main/movierecommend.ipynb"
    click Img "https://github.com/tejas1730/movie-recommandation-ai/tree/main/images/"
    click README "https://github.com/tejas1730/movie-recommandation-ai/blob/main/README.md"
    click GITATTR "https://github.com/tejas1730/movie-recommandation-ai/blob/main/.gitattributes"

    %% Styles
    classDef offline fill:#a6cee3,stroke:#1f78b4,color:#000;
    classDef online fill:#b2df8a,stroke:#33a02c,color:#000;
    classDef static fill:#ffff99,stroke:#b15928,color:#000;
    classDef doc fill:#cccccc,stroke:#666666,color:#000;
```
