olist-delivery-risk-model

Olist Delivery Risk — Gradient Boosting

Predicts whether a Brazilian e-commerce order will be delivered later than the date promised to the customer at checkout.

Registered automatically by the project's MLOps pipeline. Live application: Olist Delivery Risk Radar

Performance

Measured on 19,294 held-out orders the model never saw during training.

Models compared

That last row is the point. Only 8.11% of orders are late, so a model that ignores every input and always answers "on time" scores 91.9% accuracy while catching zero late deliveries. Accuracy is not the metric to judge this on.

The probabilities are calibrated

Class weighting made the raw model overstate risk by roughly 4.4× — orders it scored "30–40% likely late" were in reality late only 3.4% of the time.

Isotonic calibration corrected this. Mean predicted probability moved from 36.0% to 8.11% against a true rate of 8.11%, and the Brier score improved by about 60% while ROC-AUC was unchanged.

A reading of 20% from this model genuinely means about one order in five.

The threshold comes from business cost

Not the default 0.5, and not maximum F1 — both assume a missed late delivery costs the same as a false alarm. It doesn't: 54.1% of late deliveries attract a 1–2 star review, against 9.2% of on-time ones.

The shipped threshold of 0.155 minimises 5 × misses + false alarms, reducing expected cost by about 29% versus taking no action.

Usage

import joblib, json, pandas as pd
from huggingface_hub import hf_hub_download

repo = "samuelalex37/olist-delivery-risk-model"
model = joblib.load(hf_hub_download(repo, "model.joblib"))
meta = json.load(open(hf_hub_download(repo, "model_metadata.json")))

columns = meta["numeric_features"] + meta["categorical_features"]
probability = model.predict_proba(pd.DataFrame([order])[columns])[0, 1]
flagged = probability >= meta["decision_threshold"]

model.joblib contains the entire pipeline — imputation, scaling, one-hot encoding, the classifier and the calibrator — so no preprocessing code is needed and the transformations cannot drift out of step with the model.

Honest limitations

• Precision is 0.30. Roughly 7 in every 10 flagged orders would have arrived on time. Acceptable only because the intervention is cheap.
• Trained on 2016–2018 courier conditions; would need periodic retraining.
• Seller-level history was excluded, since computing it safely requires time-aware aggregation to avoid reintroducing leakage.
• ROC-AUC 0.8101 means good ranking, not certainty. This is decision support, not an oracle.

Provenance

• Trained: 2026-07-28T09:46:21
• Training rows: 77,176
• Calibration: isotonic (CalibratedClassifierCV, cv=5)
• scikit-learn: 1.9.0
• Registered by: mlops/train.py