{"id":24841475,"url":"https://github.com/rijoslal/churniq","last_synced_at":"2026-04-19T14:01:42.328Z","repository":{"id":268268622,"uuid":"867607640","full_name":"RijoSLal/ChurnIQ","owner":"RijoSLal","description":"ChurnIQ is a Streamlit app that predicts customer churn based on inputted customer details. Using a trained machine learning model, it helps businesses anticipate whether customers will stay or leave","archived":false,"fork":false,"pushed_at":"2024-12-15T16:44:11.000Z","size":339,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T05:42:06.495Z","etag":null,"topics":["python3","sklearn","sklearn-pipeline","streamlit"],"latest_commit_sha":null,"homepage":"https://churniq.streamlit.app/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RijoSLal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-04T11:38:36.000Z","updated_at":"2025-01-21T05:34:46.000Z","dependencies_parsed_at":"2024-12-15T17:42:22.378Z","dependency_job_id":null,"html_url":"https://github.com/RijoSLal/ChurnIQ","commit_stats":null,"previous_names":["rijoslal/churniq"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/RijoSLal/ChurnIQ","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RijoSLal%2FChurnIQ","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RijoSLal%2FChurnIQ/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RijoSLal%2FChurnIQ/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RijoSLal%2FChurnIQ/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RijoSLal","download_url":"https://codeload.github.com/RijoSLal/ChurnIQ/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RijoSLal%2FChurnIQ/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32009239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python3","sklearn","sklearn-pipeline","streamlit"],"created_at":"2025-01-31T07:18:06.348Z","updated_at":"2026-04-19T14:01:42.285Z","avatar_url":"https://github.com/RijoSLal.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ChurnIQ - Customer Churn Prediction\n\nChurnIQ is a Streamlit app that predicts customer churn based on inputted customer details. Using a trained machine learning model, it helps businesses anticipate whether customers will stay or leave\nHere's a sample README for your Streamlit application:\n\n## Table of Contents\n1. [Overview](#overview)\n2. [Features](#features)\n3. [Installation](#installation)\n4. [Usage](#usage)\n5. [Model Training](#model-training)\n6. [Technologies Used](#technologies-used)\n7. [Contributing](#contributing)\n8. [License](#license)\n\n## Overview\nThis application is built to predict customer churn based on customer demographics, account information, and usage patterns. It uses a machine learning model trained in Jupyter Notebook and saved with `joblib`. This model is deployed within a Streamlit interface to make it accessible for non-technical users.\n\n## Features\n- Interactive form to collect customer information.\n- Predictions based on various customer attributes (demographics, tenure, billing details, and service usage).\n- Clear visual output indicating if a customer is likely to leave (churn) or stay.\n\n## Installation\n\n### Prerequisites\n- Python 3.8+\n- Streamlit\n- joblib\n- pandas\n\n### Installation Steps\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/RijoSLal/ChurnIQ.git\n   cd ChurnIQ\n   ```\n\n2. Install the required packages:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. Run the application:\n   ```bash\n   streamlit run app.py\n   ```\n\n## Usage\n1. Open the application in your browser as directed by Streamlit.\n2. Enter customer details such as gender, age, tenure, internet service, monthly charges, etc.\n3. Click on the \"Predict\" button to get the churn prediction.\n4. The application will display whether the customer is likely to \"stay\" or \"leave.\"\n\n## Model Training\nThe machine learning model used in ChurnIQ was trained using a Jupyter Notebook and saved as `model.joblib`. Key steps in the model training include:\n- **Data Preprocessing**: Handling missing values, encoding categorical features, and feature scaling.\n- **Model Selection**: Testing multiple algorithms and selecting the best-performing model based on accuracy and recall metrics.\n- **Evaluation**: Using metrics like accuracy, precision, recall, and F1-score to evaluate the model performance.\n\nThe training notebook and additional details on model training are available in this repository.\n\n## Technologies Used\n- **Python**: Programming language\n- **Streamlit**: Web framework for building interactive applications\n- **joblib**: For model serialization\n- **pandas**: Data manipulation library\n- **scikit-learn**: For model building and evaluation\n\n## Contributing\nFeel free to fork the repository and make pull requests with improvements or new features.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frijoslal%2Fchurniq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frijoslal%2Fchurniq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frijoslal%2Fchurniq/lists"}