# mathblender17/amazon-ml-challenge-2025-price-prediction architecture

> Architecture diagram of the GitHub repository mathblender17/amazon-ml-challenge-2025-price-prediction, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mathblender17/amazon-ml-challenge-2025-price-prediction
- Repository: https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction

## Overview

This repository is a notebook-based solution to the Amazon ML Challenge 2025 product-price prediction task. Its principal workflow transforms product listing text and, in earlier experiments, images into features, trains and evaluates price models, and produces predictions. The README documents three iterations and the final text-focused ensemble; source excerpts were unavailable, so the graph reflects documented capabilities rather than unverified notebook-level call wiring.

Main entry points: [`Version 3 optuna optimised amzonmlchall.ipynb`](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version%203%20optuna%20optimised%20amzonmlchall.ipynb) (Price regressors), [`Version_O_amazon-ml-challenge-2025.ipynb`](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_O_amazon-ml-challenge-2025.ipynb) (Feature fusion), [`Version_1_strat_imd_down_amazon-ml-challenge-2025.ipynb`](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_1_strat_imd_down_amazon-ml-challenge-2025.ipynb) (Text cleaning), [`submission_lgbm_tuned.csv`](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/submission_lgbm_tuned.csv) (Tuned submission)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_text["Text Features"]
  node_text_clean["Text cleaning"]
  node_text_embeddings["Text embeddings"]
  node_text_experiments["Text alternatives"]
end

subgraph group_vision["Image Features"]
  node_image_prep["Image preparation"]
  node_image_features["Image embeddings"]
end

subgraph group_models["Modeling"]
  node_fusion["Feature fusion"]
  node_regressors["Price regressors"]
  node_tuning["Optuna tuning"]
end

subgraph group_outputs["Evaluation and Output"]
  node_evaluation["Model evaluation"]
  node_predictions["Price predictions"]
  node_submission["Tuned submission"]
end

node_listings(("Product listings"))

node_listings -->|"provides text"| node_text_clean
node_text_clean -->|"feeds features"| node_text_embeddings
node_listings -.->|"provides images"| node_image_prep
node_image_prep -.->|"prepares images"| node_image_features
node_text_embeddings -.->|"supplies text features"| node_fusion
node_image_features -.->|"supplies image features"| node_fusion
node_fusion -.->|"feeds models"| node_regressors
node_text_embeddings -->|"feeds text models"| node_regressors
node_regressors -->|"is tuned"| node_tuning
node_regressors -->|"is evaluated"| node_evaluation
node_tuning -->|"selects model"| node_predictions
node_predictions -->|"writes predictions"| node_submission
node_listings -.->|"provides text"| node_text_experiments

click node_text_clean "https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_1_strat_imd_down_amazon-ml-challenge-2025.ipynb"
click node_text_embeddings "https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version%203%20optuna%20optimised%20amzonmlchall.ipynb"
click node_text_experiments "https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_O_amazon-ml-challenge-2025.ipynb"
click node_image_prep "https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_1_strat_imd_down_amazon-ml-challenge-2025.ipynb"
click node_image_features "https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_O_amazon-ml-challenge-2025.ipynb"
click node_fusion "https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_O_amazon-ml-challenge-2025.ipynb"
click node_regressors "https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version%203%20optuna%20optimised%20amzonmlchall.ipynb"
click node_tuning "https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version%203%20optuna%20optimised%20amzonmlchall.ipynb"
click node_evaluation "https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version%203%20optuna%20optimised%20amzonmlchall.ipynb"
click node_predictions "https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version%203%20optuna%20optimised%20amzonmlchall.ipynb"
click node_submission "https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/submission_lgbm_tuned.csv"

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_text_clean,node_text_embeddings,node_text_experiments toneBlue
class node_image_prep,node_image_features toneAmber
class node_fusion,node_regressors,node_tuning toneMint
class node_evaluation,node_predictions,node_submission toneRose
class node_listings toneIndigo
```

## Components

### Text Features

- [Text cleaning](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_1_strat_imd_down_amazon-ml-challenge-2025.ipynb): `Version_1_strat_imd_down_amazon-ml-challenge-2025.ipynb`
- [Text embeddings](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version%203%20optuna%20optimised%20amzonmlchall.ipynb): `Version 3 optuna optimised amzonmlchall.ipynb`
- [Text alternatives](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_O_amazon-ml-challenge-2025.ipynb): `Version_O_amazon-ml-challenge-2025.ipynb`

### Image Features

- [Image preparation](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_1_strat_imd_down_amazon-ml-challenge-2025.ipynb): `Version_1_strat_imd_down_amazon-ml-challenge-2025.ipynb`
- [Image embeddings](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_O_amazon-ml-challenge-2025.ipynb): `Version_O_amazon-ml-challenge-2025.ipynb`

### Modeling

- [Feature fusion](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version_O_amazon-ml-challenge-2025.ipynb): `Version_O_amazon-ml-challenge-2025.ipynb`
- [Price regressors](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version%203%20optuna%20optimised%20amzonmlchall.ipynb): `Version 3 optuna optimised amzonmlchall.ipynb`
- [Optuna tuning](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version%203%20optuna%20optimised%20amzonmlchall.ipynb): `Version 3 optuna optimised amzonmlchall.ipynb`

### Evaluation and Output

- [Model evaluation](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version%203%20optuna%20optimised%20amzonmlchall.ipynb): `Version 3 optuna optimised amzonmlchall.ipynb`
- [Price predictions](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/Version%203%20optuna%20optimised%20amzonmlchall.ipynb): `Version 3 optuna optimised amzonmlchall.ipynb`
- [Tuned submission](https://github.com/mathblender17/amazon-ml-challenge-2025-price-prediction/blob/main/submission_lgbm_tuned.csv): `submission_lgbm_tuned.csv`

### Other components

- **Product listings**

## Connections

- Product listings → Text cleaning: provides text
- Text cleaning → Text embeddings: feeds features
- Product listings → Image preparation: provides images
- Image preparation → Image embeddings: prepares images
- Text embeddings → Feature fusion: supplies text features
- Image embeddings → Feature fusion: supplies image features
- Feature fusion → Price regressors: feeds models
- Text embeddings → Price regressors: feeds text models
- Price regressors → Optuna tuning: is tuned
- Price regressors → Model evaluation: is evaluated
- Optuna tuning → Price predictions: selects model
- Price predictions → Tuned submission: writes predictions
- Product listings → Text alternatives: provides text