What is fraud-detection-kenya?

This project is a machine learning pipeline that flags likely fraudulent financial transactions using synthetic data modeled on Kenyan financial systems, covering M-Pesa mobile money transfers, bank transactions, and KRA tax filings. It is built as a portfolio project focused on East African fintech and financial inclusion, and it uses fake generated data rather than real customer records. The pipeline works in three steps. First, a script generates a synthetic dataset of about 50,000 transactions using patterns meant to resemble real Kenyan financial behavior, such as M-Pesa transaction habits, KRA tax ID formats, and county level geography. Second, a training script builds a set of engineered features, such as how a transaction's amount compares to a person's usual spending, how many transactions happened in the last hour, whether the transaction happened at night, and whether declared tax income looks far lower than expected. Because actual fraud only makes up a small share of transactions, a technique called SMOTE is used to balance the training data before two models, XGBoost and LightGBM, are trained to classify transactions as fraudulent or not. The project also uses SHAP, a technique for explaining which factors influenced a given prediction. Third, a Streamlit app provides a live demo where transactions can be scanned, showing a risk gauge, a list of flagged transactions, and the ability to export flagged records as a CSV file. The README lists five categories of fraud the system is designed to catch: many rapid small transactions, a single transaction far above someone's usual amount, account takeover attempts involving a new device and location together with a large transfer, underreported income relative to expected tax obligations, and transactions structured just below a reporting threshold. The reported results show very high accuracy scores for both models, though the README notes plainly that this reflects how strongly the synthetic data was designed to signal fraud, and that real world performance would likely differ. Running the project locally requires installing the listed Python dependencies, then running the data generation script, the training script, and finally the Streamlit app in order. It can also be deployed to Streamlit's own hosting service. The project is released under the MIT license.