catboost_poetry

Predicts loan default risk using CatBoost

Overview

This project leverages the CatBoost machine learning algorithm for credit risk assessment. It's implemented using Qwak's Machine Learning Platform and the CatBoost library.

Features

• Custom CatBoost Class Definition: Customizes the base QwakModel to work with the CatBoost algorithm for credit risk prediction.

• Model Initialization: Initializes the CatBoost model with user-defined or default hyperparameters. The model is trained on a credit risk dataset and fine-tuned for optimal performance.

• Credit Risk Prediction via Qwak's Predict API: Utilizes Qwak's Predict API for assessing the probability of default based on various features like age, sex, job, housing, etc.

Functionality

The primary functionality is to predict the probability of default for credit applications. The code is designed for seamless integration with Qwak's platform and serves as a practical example for credit risk assessment tasks.

How to Test Locally

1. Clone the Repository: Clone this GitHub repository to your local machine.

2. Install Dependencies: Make sure you have the required dependencies installed, as specified in the pyproject.toml file.

   poetry -C main install

3. Install and Configure the Qwak SDK: Use your account Qwak API Key to set up your SDK locally.

   pip install qwak-sdk
   qwak configure

4. Run the Model Locally: Execute the following command to test the model locally:

   poetry run python test_model_locally.py

How to Run Remotely on Qwak

1. Build on the Qwak Platform:

   Create a new model on Qwak using the command:

   qwak models create "Credit Risk" --project "Sample Project"

   Initiate a model build with:

   qwak models build --model-id <your-model-id> .

2. Deploy the Model on the Qwak Platform with a Real-Time Endpoint:

   To deploy your model via the CLI, use the following command:

   qwak models deploy realtime --model-id <your-model-id> --build-id <your-build-id>

3. Test the Live Model with a Sample Request:

   Install the Qwak Inference SDK:

   pip install qwak-inference

   Call the Real-Time endpoint using your Model ID from the Qwak platform:

   python test_live_mode.py <your-qwak-model-id>

Project Structure

.
├── main                   # Main directory containing core code
│   ├── __init__.py        # An empty file that indicates this directory is a Python package
│   ├── model.py           # Defines the Credit Risk Model
│   ├── data.csv           # Defines the data to train the Model
│   └── pyproject.toml     # Poetry configuration
|
├── test_model_locally.py  # Script to test the model locally
├── test_live_model.py     # Script to test the live model with a sample REST request
└── README.md              # Documentation

Try Qwak's MLOps Platform for Free

Are you looking to deploy your machine learning models in a production-ready environment within minutes? Qwak offers a seamless platform to build, train, and deploy your models with ease.

Whether you're a data scientist, ML engineer, or developer, Qwak provides the tools and support to take your models from development to deployment effortlessly. Explore the platform and start deploying your models today. Try Qwak for free!