SETUP.md

<!--
Customer Churn Dataset - Setup Instructions
===========================================
Provided by: RSK World
Website: https://rskworld.in/
Email: help@rskworld.in
Phone: +91 93305 39277
Contact Page: https://rskworld.in/contact.php
-->

# Setup Instructions

Follow these steps to set up and use the Customer Churn Dataset project.

## Prerequisites

- Python 3.7 or higher
- pip (Python package installer)

## Installation Steps

### 1. Clone or Download the Project

Download the project files to your local machine.

### 2. Install Required Packages

```bash
pip install -r requirements.txt
```

Or install packages individually:

```bash
pip install pandas numpy matplotlib seaborn scikit-learn jupyter
```

### 3. Generate Dataset (Optional)

If you want to generate a new dataset with more records:

```bash
cd scripts
python generate_dataset.py
```

This will generate a dataset with 10,000 customer records.

### 4. Run Analysis Scripts

#### Data Exploration

```bash
cd scripts
python data_exploration.py
```

This will generate visualizations and save them to the `output/` directory.

#### Data Preprocessing

```bash
cd scripts
python data_preprocessing.py
```

This will preprocess the data and save it to `data/customer_churn_preprocessed.csv`.

#### Model Training

```bash
cd scripts
python model_training.py
```

This will train multiple machine learning models and compare their performance.

### 5. Use Jupyter Notebook

To use the interactive Jupyter notebook:

```bash
jupyter notebook notebooks/analysis.ipynb
```

## Project Structure

```
customer-churn/
├── data/
│ └── customer_churn.csv # Main dataset
├── scripts/
│ ├── generate_dataset.py # Dataset generator
│ ├── data_exploration.py # Data exploration
│ ├── data_preprocessing.py # Data preprocessing
│ └── model_training.py # Model training
├── notebooks/
│ └── analysis.ipynb # Jupyter notebook
├── output/ # Generated outputs
├── index.html # Demo page
├── requirements.txt # Python dependencies
└── README.md # Documentation
```

## Troubleshooting

### Missing Libraries

If you encounter import errors, make sure all required packages are installed:

```bash
pip install -r requirements.txt
```

### Path Issues

Make sure you're running scripts from the correct directory. Scripts use relative paths like `../data/customer_churn.csv`.

## Contact

For setup assistance or questions:

- 🌐 **Website:** [https://rskworld.in/](https://rskworld.in/)
- 📧 **Email:** [help@rskworld.in](mailto:help@rskworld.in)
- 📱 **Phone:** [+91 93305 39277](tel:+919330539277)
- 📞 **Contact Page:** [https://rskworld.in/contact.php](https://rskworld.in/contact.php)

**Provided by RSK World**
For more resources, visit [https://rskworld.in/](https://rskworld.in/)