# kumarsunny-nitian/fashion-rec-ai architecture

> Architecture diagram of the GitHub repository kumarsunny-nitian/fashion-rec-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kumarsunny-nitian/fashion-rec-ai
- Repository: https://github.com/kumarsunny-nitian/fashion-rec-ai

## Overview

StyleMatch is a Gradio image-to-image fashion recommender. A user uploads an image; the app preprocesses it, extracts a normalized ResNet50 embedding, compares it with embeddings of images in the local catalog, sorts by similarity, and displays up to three results. The README also describes real-time inference and future filtering, larger catalogs, vector search, and feedback, but those future capabilities are not implemented in the sampled source.

Main entry points: [`app.py`](https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py) (Recommendation handler), [`images`](https://github.com/kumarsunny-nitian/fashion-rec-ai/tree/main/images) (Fashion images)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_gradio["Gradio interface<br/>[app.py]"]
  node_gallery["Recommendation gallery<br/>[app.py]"]
end

subgraph group_inference["Recommendation inference"]
  node_recommend["Recommendation handler<br/>[app.py]"]
  node_preprocess["Image preprocessing<br/>[app.py]"]
  node_resnet["ResNet50 embedding<br/>[app.py]"]
  node_similarity["Cosine similarity<br/>[app.py]"]
  node_ranking["Top-3 ranking<br/>[app.py]"]
end

subgraph group_catalog["Image catalog"]
  node_images["Fashion images"]
end

node_user(("User"))

node_user -->|"uploads image"| node_gradio
node_gradio -->|"dispatches"| node_recommend
node_recommend -->|"extracts features"| node_preprocess
node_preprocess -->|"prepares input"| node_resnet
node_recommend -->|"reads candidates"| node_images
node_recommend -->|"compares embeddings"| node_similarity
node_similarity -->|"orders scores"| node_ranking
node_recommend -->|"returns results"| node_gallery
node_gallery -->|"displays items"| node_user

click node_gradio "https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py"
click node_recommend "https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py"
click node_preprocess "https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py"
click node_resnet "https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py"
click node_similarity "https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py"
click node_ranking "https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py"
click node_images "https://github.com/kumarsunny-nitian/fashion-rec-ai/tree/main/images"
click node_gallery "https://github.com/kumarsunny-nitian/fashion-rec-ai/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_gradio,node_gallery,node_user toneBlue
class node_recommend,node_preprocess,node_resnet,node_similarity,node_ranking toneAmber
class node_images toneMint
```

## Components

### User interface

- [Gradio interface](https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py): `app.py`
- [Recommendation gallery](https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py): `app.py`

### Recommendation inference

- [Recommendation handler](https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py): `app.py`
- [Image preprocessing](https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py): `app.py`
- [ResNet50 embedding](https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py): `app.py`
- [Cosine similarity](https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py): `app.py`
- [Top-3 ranking](https://github.com/kumarsunny-nitian/fashion-rec-ai/blob/main/app.py): `app.py`

### Image catalog

- [Fashion images](https://github.com/kumarsunny-nitian/fashion-rec-ai/tree/main/images): `images`

### Other components

- **User**

## Connections

- User → Gradio interface: uploads image
- Gradio interface → Recommendation handler: dispatches
- Recommendation handler → Image preprocessing: extracts features
- Image preprocessing → ResNet50 embedding: prepares input
- Recommendation handler → Fashion images: reads candidates
- Recommendation handler → Cosine similarity: compares embeddings
- Cosine similarity → Top-3 ranking: orders scores
- Recommendation handler → Recommendation gallery: returns results
- Recommendation gallery → User: displays items