Walkthrough

The end-to-end tour lives in notebooks/00_walkthrough.ipynb. It generates synthetic data shaped like KKBox and Orange Belgium, builds features, trains all three tracks, runs the ROI simulator, and shows how to launch the FastAPI service and Streamlit demo.

Run it from a fresh clone

git clone https://github.com/camilo-acevedo/flightrisk.git
cd flightrisk

py -3.11 -m venv .venv
.\.venv\Scripts\activate
pip install -e ".[dev]"
pip install jupyterlab

jupyter lab notebooks/00_walkthrough.ipynb

Each cell is annotated with what it does and which subpackage it exercises so the notebook doubles as a guided tour of the codebase.