Reproducibility Guide

Portable Dataset Inventory

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python src/ml_portfolio/dataset_inventory.py
python -m unittest discover -s tests -v

Generated artifacts:

• results/dataset_inventory.csv
• results/dataset_inventory.json
• figures/dataset_inventory.png

Challenge Prediction Validation

python src/challenge_2/validate_predictions.py path/to/predictions.csv

The validator checks that the CSV exists, is non-empty, contains the required prediction column, and includes the expected number of valid rows.

Historical Notebooks

Course notebooks are preserved under notebooks/coursework/. Some notebooks require optional packages or regenerated artifacts that are intentionally not versioned.