Skip to content

Latest commit

 

History

History
229 lines (160 loc) · 8.33 KB

README.md

File metadata and controls

229 lines (160 loc) · 8.33 KB

PrDS_2024__TelcoCustomerChurn


Logo

Telco Customer Churn

Telco Customer Churn
Explore the docs »

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Contributing
  5. License
  6. Contact

About The Project

Project

Telco Customer Churn focuses on the analysis of customer churn data from a telecom company to develop targeted customer retention strategies. This project leverages a dataset with comprehensive customer information, including services used, account details, and demographics.

Dataset Overview

  • Churn: Identifies customers who left in the last month.
  • Services: Details on subscribed services like phone, internet, and streaming.
  • Account Information: Customer tenure, contracts, payment methods, and charges.
  • Demographics: Information on gender, age range, partners, and dependents.

Project Goals

  • Analyze customer churn patterns.
  • Utilize predictive analytics for identifying at-risk customers.
  • Formulate focused retention strategies.

Inspiration

The project is an exploration into customer behavior modeling to enhance retention efforts and mitigate churn-related challenges for service-oriented businesses.

(back to top)

Built with

Python isort Black Ruff MyPy pre-commit GitHub Actions Poetry Pycharm Visual Studio Code Markdown License: MIT Pandas Numpy Matplotlib

(back to top)

Getting started

Prerequisites

Installation

  1. Clone the repository

    git clone https://github.com/jpcadena/PrDS_2024__TelcoCustomerChurn.git
  2. Change the directory to root project

    cd PrDS_2024__TelcoCustomerChurn
  3. Install Poetry package manager

    pip install poetry
  4. Install the project's dependencies

    poetry install
  5. Activate the environment

    poetry shell

(back to top)

Usage

  1. Replace the real datasets in the data/raw directory as the ones uploaded are small samples with 5 rows.
  2. Execute with console
    python main.py

(back to top)

Contributing

GitHub

Please read our contributing guide for details on our code of conduct, and the process for submitting pull requests to us.

(back to top)

Security

For security considerations and best practices, please refer to our Security Guide for a detailed guide.

(back to top)

Code of Conduct

We enforce a code of conduct for all maintainers and contributors. Please read our Code of Conduct to understand the expectations before making any contributions.

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

  • LinkedIn

  • Outlook

(back to top)