Skip to content
View jameskoero's full-sized avatar
💭
Open to opportunities worldwide
💭
Open to opportunities worldwide

Block or report jameskoero

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
jameskoero/README.md

Hi 👋, I'm James Koero

ML Engineer | 3 Live APIs · AUC 0.9717 · Docker · SHAP | Physics & Math · Moi University | Open to Remote Roles

LinkedIn Email Portfolio Profile Views

🧑‍💻 About Me

Self-taught ML Engineer from Kisumu, Kenya 🇰🇪 — building production-ready ML systems that solve real African problems, from flood prediction to salary transparency.

With a B.Sc. in Physics and Mathematics from Moi University and hands-on geophysical field research at KenGen's Olkaria Geothermal Project, I bring scientific rigour to every model I build. Every project ships with a live URL, SHAP explainability, and a real problem it solves — built entirely on Android (Termux · PyramIDE · Colab).

  • 🎓 B.Sc. Physics (Major) + Mathematics (Minor) — Moi University, 2012
  • 🏭 Industrial Attachment — KenGen Olkaria Geothermal Project, 2011 (MT and TEM methods)
  • 🔬 Research — Eburru Geothermal Prospect geophysical study — Prof. Mghendi Mwamburi
  • 📍 Location — Kisumu, Kenya (near Lake Victoria)
  • 🕒 Timezone — EAT (UTC+3) · Available 08:00–17:00 · Async-friendly for EU/US
  • 🌐 Open To — Remote ML Engineer / Data Science roles — US · EU · Global

🔭 Currently

  • 📖 Reading: Friedman (2001) on GBM — connecting to Nyando flood spatial autocorrelation
  • 🌱 Exploring: Computer Vision for crop disease detection (PlantVillage dataset)
  • 🎯 Target: MSc AI/CS application to VUB (Belgium) and other EU universities
  • 💬 Ask me about: flood prediction · African salary data · church management SaaS · SHAP

🚀 What I Do

  • 🧠 Build end-to-end ML systems — raw data → feature engineering → model training → live API
  • 📐 Apply Physics and Mathematics background to feature engineering and model evaluation
  • 🌍 Reduce real disaster risk — Nyando Flood AI gives 50,000 Kano Plains residents earlier warning
  • 🚢 Ship production-grade code — FastAPI · Flask · Docker · GitHub Actions CI/CD
  • 📊 Explain every prediction with SHAP — because unexplainable AI is not good enough
  • 🔒 Build secure multi-tenant SaaS — JWT rotation, RBAC, M-Pesa payment integration

🛠️ Tech Stack

Languages and Data

Python PostgreSQL

NumPy Pandas

Machine Learning and AI

Scikit-learn XGBoost

GradientBoosting SHAP

GEE

Web and Deployment

FastAPI Flask

React Streamlit

Docker Railway

Vercel GitHub Actions


📌 Featured Projects

Project Description Stack Live
🌊 Nyando Flood AI GradientBoosting · 2,308 GEE satellite points · AUC 0.97 · 50K residents sklearn · FastAPI · Docker · GEE API
💼 AfriSalaries XGBoost salary band classifier · 8 African countries · E2E 88% accuracy XGBoost · FastAPI · Vercel App
ChurchOS Africa-first multi-tenant church SaaS · M-Pesa · JWT RBAC · PWA Flask · React · PostgreSQL · Railway Demo
🚢 Titanic Survival Leak-free LR Pipeline · SHAP waterfalls · Bootstrap CIs · 13 charts · DOI sklearn · Streamlit · FastAPI Demo
🏦 Loan Risk Basel III framing · Gini 0.74 · IFRS 9 staging · EL = PD × LGD × EAD sklearn · pandas

📊 GitHub Stats

James's GitHub Stats GitHub Streak

Top Languages


🏆 GitHub Trophies

Trophies


🗺️ Project Roadmap

Status Project Domain Data
✅ Live Nyando Flood Risk AI Climate / Disaster GEE Satellite
✅ Live AfriSalaries Classifier Labour Economics Web-scraped
✅ Live ChurchOS SaaS / Web App PostgreSQL
✅ Live Loan Risk Assessment FinTech / Banking Synthetic + Real
✅ Live Titanic Survival Prediction Education / Portfolio Kaggle
🔜 Planned Malaria Outbreak Prediction Public Health WHO, DHIS2
🔜 Planned M-Pesa Fraud Detection FinTech Transactional
🔜 Planned Crop Disease Detection Computer Vision PlantVillage
🔜 Planned Lake Victoria Water Quality Environment Satellite + IoT
🔜 Planned Solar Potential Mapping Energy NASA POWER

📜 Certifications

Certificate Issuer Date Credential ID
Machine Learning using Python Programming Hub / Google Developers Launchpad Oct 2025 bae4cf502b3dfe5
Python Basics Programiz Sep 2025 08ddece2-fd4c-40eb-88d9-8f6b142466b0

🎓 Education

B.Sc. Physics (Major) + Mathematics (Minor) — Moi University, Kenya · 2008–2012

Classical Mechanics · Statistical Physics · Linear Algebra · Calculus · Numerical Methods

Research: Eburru Geothermal Prospect (MT and TEM methods) — Prof. Mghendi Mwamburi

Industrial Attachment — KenGen Olkaria Geothermal Project · 2011

Large-scale geophysical survey data collection at the most productive geothermal field in Africa. Applied MT and TEM subsurface imaging — first exposure to scientific data pipelines at production scale.


💬 Engineering Philosophy

"I build production ML systems — not just notebooks. My Physics and Mathematics background means I think carefully about what a model is actually measuring before I trust its output. Every project I ship has a live URL, SHAP explainability, and a real problem it solves — built from Kisumu, Kenya, on an Android phone, because constraints sharpen thinking."


👤 Mentored By

  • Prof. Johan Loeckx — VUB AI Lab, Vrije Universiteit Brussel, Belgium
  • Prof. Samuel Liyala — Jaramogi Oginga Odinga University of Science and Technology, Kenya

Available for remote ML / Data Science roles — US · EU · Global

Building from Kisumu, Kenya — one model at a time 🌍

Pinned Loading

  1. nyando-flood-ai nyando-flood-ai Public

    AI-powered flood risk prediction for Nyando Basin, Kenya. XGBoost + SHAP + FastAPI + React. AUC-ROC 0.9717. 100% open data — Kenya DPA 2019 compliant.

    Python

  2. afrisalaries afrisalaries Public

    ML model predicting hidden tech salaries across Africa from job descriptions | XGBoost, FastAPI, Docker, SHAP, React

    Python

  3. titanic-survival-prediction titanic-survival-prediction Public

    Senior-grade Logistic Regression on Titanic · Leak-free sklearn Pipeline + ColumnTransformer · SHAP waterfalls for Andrews/Dean/Brown · 13 evaluation charts · Bootstrap 95% CIs · F2-tuned threshold…

    Python

  4. ChurchOS ChurchOS Public

    Africa-first multi-tenant SaaS for church governance, finance, and member management. Flask + React + PostgreSQL + M-Pesa.

    JavaScript

  5. loan-risk-assessment loan-risk-assessment Public

    Advanced Loan Default Risk Assessment" Loan default risk ML system · GradientBoosting · SHAP · Python

    Jupyter Notebook

  6. jameskoero jameskoero Public