# suvam-09/movie-recommendation-system architecture

> Architecture diagram of the GitHub repository suvam-09/movie-recommendation-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/suvam-09/movie-recommendation-system
- Repository: https://github.com/suvam-09/movie-recommendation-system

## Overview

This is a Streamlit content-based movie recommender. A user selects a movie and requests recommendations; the app ranks precomputed similarity scores, resolves the six results against its movie catalog, fetches poster metadata from TMDB, and displays the recommendations. The runtime loads two pickle artifacts. The README describes the TMDB dataset and cosine-similarity approach, but the excerpts do not show how the artifacts are produced, so that offline preparation flow is not drawn.

Main entry points: [`app.py`](https://github.com/suvam-09/movie-recommendation-system/blob/main/app.py) (Similarity ranker), [`movie_list.pkl`](https://github.com/suvam-09/movie-recommendation-system/blob/main/movie_list.pkl) (Movie catalog), [`similarity_check.pkl`](https://github.com/suvam-09/movie-recommendation-system/blob/main/similarity_check.pkl) (Similarity matrix)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_interface["Selection and display<br/>[app.py]"]
end

subgraph group_recommendation["Recommendation runtime"]
  node_ranker["Similarity ranker<br/>[app.py]"]
  node_catalog[("Movie catalog<br/>[movie_list.pkl]")]
  node_scores[("Similarity matrix")]
end

subgraph group_integrations["External media"]
  node_poster_lookup["Poster lookup<br/>[app.py]"]
end

node_user(("Movie seeker"))
node_tmdb["TMDB movie API"]
node_image_cdn["TMDB image CDN"]

node_user -->|"selects movie"| node_interface
node_interface -->|"requests recommendations"| node_ranker
node_ranker -->|"reads scores"| node_scores
node_ranker -->|"looks up titles"| node_catalog
node_ranker -->|"requests posters"| node_poster_lookup
node_poster_lookup -->|"fetches metadata"| node_tmdb
node_poster_lookup -->|"builds image URL"| node_image_cdn
node_interface -->|"displays results"| node_user

click node_interface "https://github.com/suvam-09/movie-recommendation-system/blob/main/app.py"
click node_ranker "https://github.com/suvam-09/movie-recommendation-system/blob/main/app.py"
click node_catalog "https://github.com/suvam-09/movie-recommendation-system/blob/main/movie_list.pkl"
click node_scores "https://github.com/suvam-09/movie-recommendation-system/blob/main/similarity_check.pkl"
click node_poster_lookup "https://github.com/suvam-09/movie-recommendation-system/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_interface toneBlue
class node_ranker,node_catalog,node_scores toneAmber
class node_poster_lookup,node_tmdb toneMint
class node_user,node_image_cdn toneIndigo
```

## Components

### User experience

- [Selection and display](https://github.com/suvam-09/movie-recommendation-system/blob/main/app.py): `app.py`

### Recommendation runtime

- [Similarity ranker](https://github.com/suvam-09/movie-recommendation-system/blob/main/app.py): `app.py`
- [Movie catalog](https://github.com/suvam-09/movie-recommendation-system/blob/main/movie_list.pkl): `movie_list.pkl`
- [Similarity matrix](https://github.com/suvam-09/movie-recommendation-system/blob/main/similarity_check.pkl): `similarity_check.pkl`

### External media

- [Poster lookup](https://github.com/suvam-09/movie-recommendation-system/blob/main/app.py): `app.py`

### Other components

- **Movie seeker**
- **TMDB movie API**
- **TMDB image CDN**

## Connections

- Movie seeker → Selection and display: selects movie (evidence: `README.md`)
- Selection and display → Similarity ranker: requests recommendations (evidence: `app.py`)
- Similarity ranker → Similarity matrix: reads scores (evidence: `app.py`)
- Similarity ranker → Movie catalog: looks up titles (evidence: `app.py`)
- Similarity ranker → Poster lookup: requests posters (evidence: `app.py`)
- Poster lookup → TMDB movie API: fetches metadata (evidence: `app.py`)
- Poster lookup → TMDB image CDN: builds image URL (evidence: `app.py`)
- Selection and display → Movie seeker: displays results (evidence: `app.py`)
