# ad668/movierecommendsystem architecture

> Architecture diagram of the GitHub repository ad668/movierecommendsystem, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ad668/movierecommendsystem
- Repository: https://github.com/ad668/movierecommendsystem

## Overview

This small Streamlit application prepares movie data in a Jupyter notebook, then loads the resulting movie and similarity pickles to recommend titles. The user selects a movie and requests recommendations; the app ranks similar movies and displays the results. The notebook’s internal processing is not shown, so its preparation steps are represented only at the documented level.

Main entry points: [`app.py`](https://github.com/ad668/movierecommendsystem/blob/main/app.py) (Movie selection UI), [`Movie Recommedation System.ipynb`](https://github.com/ad668/movierecommendsystem/blob/main/Movie%20Recommedation%20System.ipynb) (Data preparation notebook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_preparation["Data preparation"]
  node_notebook["Data preparation notebook"]
  node_artifacts["Pickle artifacts"]
end

subgraph group_application["Recommendation app"]
  node_interface["Movie selection UI<br/>[app.py]"]
  node_ranker["Similarity ranking<br/>[app.py]"]
  node_movie_data[("Movie and similarity data<br/>[app.py]")]
end

node_user(("User"))
node_datasets["TMDB datasets"]

node_datasets -->|"provides data"| node_notebook
node_notebook -->|"generates pickles"| node_artifacts
node_artifacts -->|"loaded as"| node_movie_data
node_user -->|"selects movie"| node_interface
node_interface -->|"requests recommendations"| node_ranker
node_ranker -->|"reads titles and similarity"| node_movie_data
node_interface -->|"displays results"| node_user

click node_notebook "https://github.com/ad668/movierecommendsystem/blob/main/Movie%20Recommedation%20System.ipynb"
click node_interface "https://github.com/ad668/movierecommendsystem/blob/main/app.py"
click node_ranker "https://github.com/ad668/movierecommendsystem/blob/main/app.py"
click node_movie_data "https://github.com/ad668/movierecommendsystem/blob/main/app.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_notebook,node_artifacts,node_user toneBlue
class node_interface,node_ranker,node_movie_data toneAmber
class node_datasets toneIndigo
```

## Components

### Data preparation

- [Data preparation notebook](https://github.com/ad668/movierecommendsystem/blob/main/Movie%20Recommedation%20System.ipynb): `Movie Recommedation System.ipynb`
- **Pickle artifacts**

### Recommendation app

- [Movie selection UI](https://github.com/ad668/movierecommendsystem/blob/main/app.py): `app.py`
- [Similarity ranking](https://github.com/ad668/movierecommendsystem/blob/main/app.py): `app.py`
- [Movie and similarity data](https://github.com/ad668/movierecommendsystem/blob/main/app.py): `app.py`

### Other components

- **User**
- **TMDB datasets**

## Connections

- TMDB datasets → Data preparation notebook: provides data (evidence: `README.md`)
- Data preparation notebook → Pickle artifacts: generates pickles (evidence: `README.md`)
- Pickle artifacts → Movie and similarity data: loaded as (evidence: `app.py`)
- User → Movie selection UI: selects movie (evidence: `app.py`)
- Movie selection UI → Similarity ranking: requests recommendations (evidence: `app.py`)
- Similarity ranking → Movie and similarity data: reads titles and similarity (evidence: `app.py`)
- Movie selection UI → User: displays results (evidence: `app.py`)
