# siddhartha-sai-17/product-vision-recommedation architecture

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

- Interactive diagram: https://gitdiagram.com/siddhartha-sai-17/product-vision-recommedation
- Repository: https://github.com/siddhartha-sai-17/product-vision-recommedation

## Overview

This repository is a fashion-image visual search and recommendation product, with a Streamlit dashboard and a CLI for preparing data, training models, and evaluation. The user workflow is image upload, preprocessing, embedding selection, similarity retrieval, metadata filtering/ranking, and product display. Other documented branches include model comparison, evaluation, dataset exploration, explainability, and live telemetry. Several page implementations are unsampled; those capabilities and their paths come from the README and tree, so uncertain internal links are omitted.

Main entry points: [`main.py`](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/main.py) (Pipeline CLI), [`recommendation/recommendation_service.py`](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/recommendation_service.py) (Recommendation service), [`app/pages/2_Image_Search.py`](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/2_Image_Search.py) (Image search), [`recommendation/cache_manager.py`](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/cache_manager.py) (Model and index cache)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard"]
  node_dashboard["Streamlit entry<br/>[streamlit_app.py]"]
  node_search_page["Image search<br/>[2_Image_Search.py]"]
  node_compare_page["Model comparison"]
  node_eval_page["Evaluation dashboard"]
  node_dataset_page["Dataset explorer"]
  node_logs_page["Telemetry and logs<br/>[8_System_Logs.py]"]
  node_session["Search session state<br/>[session_manager.py]"]
  node_performance_page["Performance dashboard<br/>[4_Performance.py]"]
end

subgraph group_recommend["Visual Retrieval"]
  node_model_selection["Embedding selection"]
  node_recommend_engine["Recommendation entry"]
  node_recommend_service["Recommendation service"]
  node_similarity["Similarity search"]
  node_ranking["Filter and rank<br/>[ranking_engine.py]"]
  node_cache["Model and index cache<br/>[cache_manager.py]"]
  node_embedding_store[("Embedding database")]
  node_faiss["FAISS index<br/>[faiss_engine.py]"]
end

subgraph group_ml["Data and Models"]
  node_preprocess["Image preprocessing"]
  node_model_factory["Model architectures<br/>[model_factory.py]"]
  node_model_loader["Model loader<br/>[model_loader.py]"]
  node_checkpoints[("Model checkpoints")]
  node_dataset_prep["Dataset preparation<br/>[dataset_subset.py]"]
  node_dataset_validation["Dataset validation"]
  node_transfer_training["Transfer training<br/>[trainer.py]"]
  node_siamese_training["Siamese training"]
  node_cli["Pipeline CLI<br/>[main.py]"]
end

subgraph group_ops["Evaluation and Operations"]
  node_evaluation["Retrieval evaluation"]
  node_comparison["Model comparison<br/>[comparison.py]"]
  node_reports["Reports"]
  node_visualization["Plots and Grad-CAM<br/>[visualization.py]"]
end

node_shopper(("Dashboard user"))

node_shopper -->|"opens"| node_dashboard
node_dashboard -->|"initializes state"| node_session
node_shopper -->|"uploads image"| node_search_page
node_search_page -->|"requests recommendations"| node_recommend_engine
node_search_page -->|"uses search state"| node_session
node_recommend_engine -->|"delegates to"| node_recommend_service
node_recommend_service -->|"preprocesses query"| node_preprocess
node_recommend_service -->|"selects embedding"| node_model_selection
node_recommend_service -->|"loads cached assets"| node_cache
node_recommend_service -->|"computes similarity"| node_similarity
node_recommend_service -->|"ranks candidates"| node_ranking
node_cache -->|"loads vectors and metadata"| node_embedding_store
node_cache -->|"loads or builds index"| node_faiss
node_model_selection -->|"selects checkpoint"| node_checkpoints
node_model_loader -->|"creates model"| node_model_factory
node_model_loader -->|"loads checkpoint"| node_checkpoints
node_shopper -->|"compares models"| node_compare_page
node_shopper -->|"views metrics"| node_eval_page
node_shopper -->|"explores catalog"| node_dataset_page
node_shopper -->|"views telemetry"| node_logs_page
node_shopper -->|"views performance"| node_performance_page
node_cli -->|"prepares dataset"| node_dataset_prep
node_cli -->|"validates dataset"| node_dataset_validation
node_cli -->|"starts training"| node_transfer_training
node_cli -->|"starts training"| node_siamese_training
node_transfer_training -->|"builds architecture"| node_model_factory
node_transfer_training -->|"saves checkpoints"| node_checkpoints
node_siamese_training -->|"builds architecture"| node_model_factory
node_cli -->|"runs comparison"| node_comparison
node_cli -->|"generates report"| node_reports
node_shopper -.->|"views explainability"| node_visualization
node_eval_page -.->|"presents metrics"| node_evaluation
node_compare_page -.->|"presents results"| node_comparison
node_performance_page -.->|"shares telemetry"| node_logs_page

click node_dashboard "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/streamlit_app.py"
click node_search_page "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/2_Image_Search.py"
click node_compare_page "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/3_Model_Comparison.py"
click node_eval_page "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/5_Evaluation_Metrics.py"
click node_dataset_page "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/7_Dataset_Explorer.py"
click node_logs_page "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/8_System_Logs.py"
click node_session "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/utils/session_manager.py"
click node_preprocess "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/preprocessing/image_preprocessor.py"
click node_model_selection "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/embedding_selector.py"
click node_recommend_engine "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/recommendation_engine.py"
click node_recommend_service "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/recommendation_service.py"
click node_similarity "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/similarity_engine.py"
click node_ranking "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/ranking_engine.py"
click node_cache "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/cache_manager.py"
click node_embedding_store "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/embedding_database.py"
click node_faiss "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/faiss_engine.py"
click node_model_factory "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/models/model_factory.py"
click node_model_loader "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/models/model_loader.py"
click node_checkpoints "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/models/checkpoint_manager.py"
click node_dataset_prep "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/preprocessing/dataset_subset.py"
click node_dataset_validation "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/preprocessing/dataset_validator.py"
click node_transfer_training "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/training/trainer.py"
click node_siamese_training "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/training/siamese_training.py"
click node_cli "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/main.py"
click node_evaluation "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/evaluation_engine.py"
click node_comparison "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/comparison.py"
click node_reports "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/report_generator.py"
click node_visualization "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/utils/visualization.py"
click node_performance_page "https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/4_Performance.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_dashboard,node_search_page,node_compare_page,node_eval_page,node_dataset_page,node_logs_page,node_session,node_performance_page,node_shopper toneBlue
class node_model_selection,node_recommend_engine,node_recommend_service,node_similarity,node_ranking,node_cache,node_embedding_store,node_faiss toneAmber
class node_preprocess,node_model_factory,node_model_loader,node_checkpoints,node_dataset_prep,node_dataset_validation,node_transfer_training,node_siamese_training,node_cli toneMint
class node_evaluation,node_comparison,node_reports,node_visualization toneRose
```

## Components

### Dashboard

- [Streamlit entry](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/streamlit_app.py): `app/streamlit_app.py`
- [Image search](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/2_Image_Search.py): `app/pages/2_Image_Search.py`
- [Model comparison](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/3_Model_Comparison.py): `app/pages/3_Model_Comparison.py`
- [Evaluation dashboard](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/5_Evaluation_Metrics.py): `app/pages/5_Evaluation_Metrics.py`
- [Dataset explorer](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/7_Dataset_Explorer.py): `app/pages/7_Dataset_Explorer.py`
- [Telemetry and logs](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/8_System_Logs.py): `app/pages/8_System_Logs.py`
- [Search session state](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/utils/session_manager.py): `app/utils/session_manager.py`
- [Performance dashboard](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/app/pages/4_Performance.py): `app/pages/4_Performance.py`

### Visual Retrieval

- [Embedding selection](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/embedding_selector.py): `recommendation/embedding_selector.py`
- [Recommendation entry](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/recommendation_engine.py): `recommendation/recommendation_engine.py`
- [Recommendation service](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/recommendation_service.py): `recommendation/recommendation_service.py`
- [Similarity search](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/similarity_engine.py): `recommendation/similarity_engine.py`
- [Filter and rank](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/ranking_engine.py): `recommendation/ranking_engine.py`
- [Model and index cache](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/cache_manager.py): `recommendation/cache_manager.py`
- [Embedding database](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/embedding_database.py): `recommendation/embedding_database.py`
- [FAISS index](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/faiss_engine.py): `recommendation/faiss_engine.py`

### Data and Models

- [Image preprocessing](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/preprocessing/image_preprocessor.py): `preprocessing/image_preprocessor.py`
- [Model architectures](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/models/model_factory.py): `models/model_factory.py`
- [Model loader](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/models/model_loader.py): `models/model_loader.py`
- [Model checkpoints](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/models/checkpoint_manager.py): `models/checkpoint_manager.py`
- [Dataset preparation](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/preprocessing/dataset_subset.py): `preprocessing/dataset_subset.py`
- [Dataset validation](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/preprocessing/dataset_validator.py): `preprocessing/dataset_validator.py`
- [Transfer training](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/training/trainer.py): `training/trainer.py`
- [Siamese training](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/training/siamese_training.py): `training/siamese_training.py`
- [Pipeline CLI](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/main.py): `main.py`

### Evaluation and Operations

- [Retrieval evaluation](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/evaluation_engine.py): `recommendation/evaluation_engine.py`
- [Model comparison](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/comparison.py): `recommendation/comparison.py`
- [Reports](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/recommendation/report_generator.py): `recommendation/report_generator.py`
- [Plots and Grad-CAM](https://github.com/siddhartha-sai-17/product-vision-recommedation/blob/main/utils/visualization.py): `utils/visualization.py`

### Other components

- **Dashboard user**

## Connections

- Dashboard user → Streamlit entry: opens
- Streamlit entry → Search session state: initializes state (evidence: `app/streamlit_app.py`)
- Dashboard user → Image search: uploads image
- Image search → Recommendation entry: requests recommendations (evidence: `app/pages/2_Image_Search.py`)
- Image search → Search session state: uses search state (evidence: `app/pages/2_Image_Search.py`)
- Recommendation entry → Recommendation service: delegates to (evidence: `recommendation/recommendation_engine.py`)
- Recommendation service → Image preprocessing: preprocesses query (evidence: `recommendation/recommendation_service.py`)
- Recommendation service → Embedding selection: selects embedding (evidence: `recommendation/recommendation_service.py`)
- Recommendation service → Model and index cache: loads cached assets (evidence: `recommendation/recommendation_service.py`)
- Recommendation service → Similarity search: computes similarity (evidence: `recommendation/recommendation_service.py`)
- Recommendation service → Filter and rank: ranks candidates (evidence: `recommendation/recommendation_service.py`)
- Model and index cache → Embedding database: loads vectors and metadata (evidence: `recommendation/cache_manager.py`)
- Model and index cache → FAISS index: loads or builds index (evidence: `recommendation/cache_manager.py`)
- Embedding selection → Model checkpoints: selects checkpoint (evidence: `recommendation/embedding_selector.py`)
- Model loader → Model architectures: creates model (evidence: `models/model_loader.py`)
- Model loader → Model checkpoints: loads checkpoint (evidence: `models/model_loader.py`)
- Dashboard user → Model comparison: compares models
- Dashboard user → Evaluation dashboard: views metrics
- Dashboard user → Dataset explorer: explores catalog
- Dashboard user → Telemetry and logs: views telemetry
- Dashboard user → Performance dashboard: views performance
- Pipeline CLI → Dataset preparation: prepares dataset (evidence: `main.py`)
- Pipeline CLI → Dataset validation: validates dataset (evidence: `main.py`)
- Pipeline CLI → Transfer training: starts training (evidence: `main.py`)
- Pipeline CLI → Siamese training: starts training (evidence: `main.py`)
- Transfer training → Model architectures: builds architecture (evidence: `training/trainer.py`)
- Transfer training → Model checkpoints: saves checkpoints (evidence: `training/trainer.py`)
- Siamese training → Model architectures: builds architecture (evidence: `training/siamese_training.py`)
- Pipeline CLI → Model comparison: runs comparison (evidence: `main.py`)
- Pipeline CLI → Reports: generates report (evidence: `main.py`)
- Dashboard user → Plots and Grad-CAM: views explainability
- Evaluation dashboard → Retrieval evaluation: presents metrics
- Model comparison → Model comparison: presents results
- Performance dashboard → Telemetry and logs: shares telemetry
