Welcome to the Software Engineer (ML & LLMs) Application Challenge. In this, you will have the opportunity to get closer to a part of the reality of the role, and demonstrate your skills and knowledge in machine learning and cloud.
A jupyter notebook (exploration.ipynb
) has been provided with the work of a Data Scientist (from now on, the DS). The DS, trained a model to predict the probability of delay for a flight taking off or landing at SCL airport. The model was trained with public and real data, below we provide you with the description of the dataset:
Column | Description |
---|---|
Fecha-I |
Scheduled date and time of the flight. |
Vlo-I |
Scheduled flight number. |
Ori-I |
Programmed origin city code. |
Des-I |
Programmed destination city code. |
Emp-I |
Scheduled flight airline code. |
Fecha-O |
Date and time of flight operation. |
Vlo-O |
Flight operation number of the flight. |
Ori-O |
Operation origin city code. |
Des-O |
Operation destination city code. |
Emp-O |
Airline code of the operated flight. |
DIA |
Day of the month of flight operation. |
MES |
Number of the month of operation of the flight. |
AÑO |
Year of flight operation. |
DIANOM |
Day of the week of flight operation. |
TIPOVUELO |
Type of flight, I =International, N =National. |
OPERA |
Name of the airline that operates. |
SIGLAORI |
Name city of origin. |
SIGLADES |
Destination city name. |
In addition, the DS considered relevant the creation of the following columns:
Column | Description |
---|---|
high_season |
1 if Date-I is between Dec-15 and Mar-3, or Jul-15 and Jul-31, or Sep-11 and Sep-30, 0 otherwise. |
min_diff |
difference in minutes between Date-O and Date-I |
period_day |
morning (between 5:00 and 11:59), afternoon (between 12:00 and 18:59) and night (between 19:00 and 4:59), based on Date-I . |
delay |
1 if min_diff > 15, 0 if not. |
-
Create a repository in github and copy all the challenge content into it. Remember that the repository must be public.
-
Use the main branch for any official release that we should review. It is highly recommended to use GitFlow development practices. NOTE: do not delete your development branches.
-
Please, do not change the structure of the challenge (names of folders and files).
-
All the documentation and explanations that you have to give us must go in the
challenge.md
file insidedocs
folder. -
To send your challenge, you must do a
POST
request to:https://advana-challenge-check-api-cr-k4hdbggvoq-uc.a.run.app/software-engineer
This is an example of thebody
you must send:{ "name": "Juan Perez", "mail": "juan.perez@example.com", "github_url": "https://github.com/juanperez/latam-challenge.git", "api_url": "https://juan-perez.api" }
If your request was successful, you will receive this message:
{ "status": "OK", "detail": "your request was received" }
NOTE: We recommend to send the challenge even if you didn't manage to finish all the parts.
We need to operationalize the data science work for the airport team. For this, we have decided to enable an API
in which they can consult the delay prediction of a flight.
We recommend reading the entire challenge (all its parts) before you start developing.
In order to operationalize the model, transcribe the .ipynb
file into the model.py
file:
- If you find any bug, fix it.
- The DS proposed a few models in the end. Choose the best model at your discretion, argue why. It is not necessary to make improvements to the model.
- Apply all the good programming practices that you consider necessary in this item.
- The model should pass the tests by running
make model-test
. r
Note:
- You cannot remove or change the name or arguments of provided methods.
- You can change/complete the implementation of the provided methods.
- You can create the extra classes and methods you deem necessary.
Deploy the model in an API
with FastAPI
using the api.py
file.
- The
API
should pass the tests by runningmake api-test
.
Note:
- You cannot use other framework.
Deploy the API
in your favorite cloud provider (we recomend to use GCP).
- Put the
API
's url in theMakefile
(line 26
). - The
API
should pass the tests by runningmake stress-test
.
Note:
- It is important that the API is deployed until we review the tests.
We are looking for a proper CI/CD
implementation for this development.
- Create a new folder called
.github
and copy theworkflows
folder that we provided inside it. - Complete both
ci.yml
andcd.yml
(consider what you did in the previous parts).