tarekmasryo's picture
Update README.md
324b0e7 verified

A newer version of the Streamlit SDK is available: 1.52.1

Upgrade
metadata
sdk: streamlit
sdk_version: 1.51.0
license: apache-2.0

πŸ’³ Credit Card Fraud Detection Dashboard

Streamlit
Data License: CC BY-NC 4.0
Made with ❀️ by Tarek Masryo


πŸ“Œ Overview

Interactive dashboard built with Streamlit, Plotly, and Scikit-learn for real-time fraud detection analysis.
It demonstrates a business-aware ML pipeline on the classic Credit Card Fraud Dataset (284,807 transactions, only 492 frauds β‰ˆ 0.17%).

  • πŸ” Upload your own transaction CSV or use the built-in dataset
  • βš–οΈ Custom decision thresholds with cost-sensitive analysis
  • πŸ“Š Confusion matrix, ROC/PR curves, and cost–threshold visualization
  • πŸ’‘ Permutation feature importance for interpretability
  • 🧾 Segmented performance profiling (by amount, time of day, etc.)

πŸ“Š Dashboard Preview

Data Overview

Data

Prediction Engine

Prediction

Model Metrics

Metrics

Model Insights

Insights

Data Quality & Segments

Segments


πŸ”‘ Features

  • Models: RandomForest & XGBoost (calibrated)
  • Presets: Strict / Balanced / Lenient thresholds
  • Threshold Finder: auto-select by target Precision/Recall
  • Cost Analysis: business-aligned FP vs FN costs
  • Visuals: Confusion matrix, ROC, PR, cost vs threshold curves
  • Insights: Permutation importance, segmented KPIs
  • Data Handling: automatic schema validation + engineered features (log(Amount), business hours, night proxy)

πŸš€ Run Locally

Clone the repo and install requirements:

git clone https://github.com/tarekmasryo/fraud-detection-dashboard.git
cd fraud-detection-dashboard
pip install -r requirements.txt

Run the app:

streamlit run app.py

☁️ Deploy on Hugging Face Spaces

This repository is ready to be deployed as a Streamlit Space on Hugging Face.
Make sure to include the following files in your repo:

  • app.py β†’ main app file
  • requirements.txt β†’ Python dependencies
  • artifacts/ β†’ trained model .joblib files and thresholds.json
  • data/creditcard.csv (optional, for default dataset)

πŸ“œ License & Attribution


Related Repositories