README.md

• Olist : Categorize clients for a e-commerce website
  • Installation
    • Prerequisites
    • Virtual environment
    • Dependencies
  • Usage
    • Run Notebook
    • Quality Assurance
  • Troubleshooting

---

Olist : Categorize clients for a e-commerce website

Repository of OpenClassrooms' AI Engineer path, project #5

Goal : use Jupyter Notebook and Scikit-Learn to create, assess and improve a clustering model based on customers and orders data.

You can see the results here :

• Presentation

• HTML page with interactive plots

Installation

Prerequisites

• Python 3.9

Virtual environment

make venv
source env/bin/activate

Dependencies

# pip install kaggle jupyterlab ipywidgets numpy pandas scipy statsmodels sklearn plotly matplotlib
# > or :
# pip install -r requirements.txt
# > or :
make install

Usage

Run Notebook

jupyter-lab notebooks/main.ipynb

Quality Assurance

# make isort
# make format
# make lint
# make bandit
# make mypy
# make test
# > or just :
make qa

Troubleshooting

• Fix Plotly issues with JupyterLab

cf. Plotly troubleshooting

jupyter labextension install jupyterlab-plotly

• If using Jupyter Notebook instead of JupyterLab, uncomment the following lines in the notebook

import plotly.io as pio
pio.renderers.default='notebook'