{"id":25376428,"url":"https://github.com/sugam-arora/rfm","last_synced_at":"2025-04-09T10:12:32.154Z","repository":{"id":260313237,"uuid":"880942632","full_name":"SUGAM-ARORA/RFM","owner":"SUGAM-ARORA","description":"RFM Analysis Dashboard 📊 is an interactive analytics tool designed to segment customers based on Recency, Frequency, and Monetary (RFM) values. It provides data-driven insights, visualizations, and predictive analytics to help businesses optimize customer retention, engagement, and marketing strategies.","archived":false,"fork":false,"pushed_at":"2025-04-03T19:18:28.000Z","size":216,"stargazers_count":1,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T10:12:25.665Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://wce3vqv69c4prxooewjnpb.streamlit.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SUGAM-ARORA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-30T16:27:53.000Z","updated_at":"2025-04-03T19:18:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"1a4166c0-baee-437a-85fc-61b58dd1bd5c","html_url":"https://github.com/SUGAM-ARORA/RFM","commit_stats":null,"previous_names":["sugam-arora/rfm-analysis-dashboard","sugam-arora/rfm"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUGAM-ARORA%2FRFM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUGAM-ARORA%2FRFM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUGAM-ARORA%2FRFM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUGAM-ARORA%2FRFM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SUGAM-ARORA","download_url":"https://codeload.github.com/SUGAM-ARORA/RFM/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248018068,"owners_count":21034048,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2025-02-15T04:23:43.316Z","updated_at":"2025-04-09T10:12:32.083Z","avatar_url":"https://github.com/SUGAM-ARORA.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"### **RFM Analysis Dashboard 📊**  \n\n\n**RFM Analysis Dashboard** is a powerful tool designed to analyze customer behavior using **Recency, Frequency, and Monetary (RFM) Analysis**. It helps businesses segment customers based on their purchasing patterns and develop data-driven marketing strategies.  \n\n---  \n\n## **🚀 Features**  \n\n### 🔍 **Customer Segmentation**  \n- Categorizes customers based on **Recency (last purchase), Frequency (number of purchases), and Monetary value (total spend)**  \n- Identifies **high-value, at-risk, and inactive customers**  \n\n### 📊 **Interactive Visualizations**  \n- **RFM Score Heatmaps** for quick insights  \n- **Customer Clusters** with visual segmentation  \n- **Trend Analysis Charts** for purchase patterns  \n\n### ⚡ **Actionable Insights**  \n- Helps in **customer retention strategies**  \n- Assists in **personalized marketing campaigns**  \n- Improves **customer lifetime value (CLV) predictions**  \n\n### 📂 **Data Management**  \n- Accepts **CSV uploads** for easy data import  \n- **Automated preprocessing** of customer transactions  \n- Supports **filtering, sorting, and export** of RFM scores  \n\n### 🎨 **Modern UI/UX**  \n- **Dark/Light mode toggle**  \n- **Fully responsive design**  \n- **Dashboard-style layout with smooth navigation**  \n\n---  \n\n## **🛠️ Tech Stack**  \n**Python, Streamlit, Pandas, NumPy, Matplotlib, Seaborn, Scikit-Learn**  \n\n---  \n\n## **📌 Installation \u0026 Setup**  \n\n### **🔧 Prerequisites**  \nEnsure you have the following installed:  \n- Python `3.8+`  \n- pip or conda for package management  \n\n### **🖥️ Clone the Repository**  \n```bash\ngit clone https://github.com/SUGAM-ARORA/RFM-Analysis-Dashboard.git\ncd RFM-Analysis-Dashboard\n```\n\n### **📦 Install Dependencies**  \n```bash\npip install streamlit\n```\n\n### **🚀 Run the Application**  \n```bash\npip install -r requirements.txt\n```\n\n### **🚀 Run the Streamlit App**  \n```bash\npython -m streamlit run rfm_dashboard.py\n```\nOpen http://localhost:8501 in your browser to access the dashboard.\n\n\n---  \n\n## **📊 Understanding RFM Analysis**  \n\n**1️⃣ Recency (R)** → *How recently has the customer made a purchase?*  \n**2️⃣ Frequency (F)** → *How often does the customer purchase?*  \n**3️⃣ Monetary (M)** → *How much has the customer spent?*  \n\nThe system assigns **RFM scores (1-5)** to each customer based on these metrics, enabling **customer segmentation and targeted marketing strategies**.  \n\n---  \n\n## **📖 API Endpoints**  \n\n### **🔹 Upload Data**  \n`POST /upload` → Upload a CSV file containing customer transactions  \n\n### **🔹 Get RFM Scores**  \n`GET /rfm-scores` → Retrieve RFM scores and segments  \n\n### **🔹 Export Data**  \n`GET /export` → Download processed RFM data in CSV format  \n\n---  \n\n## **📜 License**  \nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.  \n\n---  \n\n## **🤝 Contributing**  \nWe welcome contributions! Please read the [Contributing Guide](CONTRIBUTING.md) before submitting changes.  \n\n---  \n\n## 🧑‍💼 Maintainers\n\n\u003cdiv\u003e\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/SUGAM-ARORA\"\u003e\u003cimg src=\"https://github.com/SUGAM-ARORA/UniCollab/assets/96546088/09d60ee5-8215-4327-808f-4edf119370b6\" width=150px height=150px /\u003e\u003c/a\u003e\u003c/br\u003e \u003ch4 style=\"color:cyan;\"\u003eSugam Arora\u003c/h4\u003e\n \u003ca href=\"https://www.linkedin.com/in/sugamarora23/\"\u003e\u003cimg src=\"https://img.icons8.com/fluency/2x/linkedin.png\" width=\"32px\" height=\"32px\"\u003e\u003c/img\u003e\u003c/a\u003e\n \u003ca href=\"https://github.com/SUGAM-ARORA\"\u003e\u003cimg src=\"https://img.icons8.com/fluency/2x/github.png\" width=\"32px\" height=\"32px\"\u003e\u003c/img\u003e\u003c/a\u003e\n\n   \u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003chttps://github.com/Ojas-Arora\"\u003e\u003cimg src=\"https://media.licdn.com/dms/image/v2/D5603AQF-0oeQKjHUGg/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1731090529812?e=1740614400\u0026v=beta\u0026t=urY8EklFDUSFuxKUQtHCq6eK8inuueVUkFH1u9wypQM\" width=150px height=150px /\u003e\u003c/a\u003e\u003c/br\u003e \u003ch4 style=\"color:cyan;\"\u003eOjas Arora\u003c/h4\u003e\n \u003ca href=\"https://www.linkedin.com/in/ojasarora14/\"\u003e\u003cimg src=\"https://img.icons8.com/fluency/2x/linkedin.png\" width=\"32px\" height=\"32px\"\u003e\u003c/img\u003e\u003c/a\u003e\n \u003ca href=\"https://github.com/Ojas-Arora\"\u003e\u003cimg src=\"https://img.icons8.com/fluency/2x/github.png\" width=\"32px\" height=\"32px\"\u003e\u003c/img\u003e\u003c/a\u003e\n   \u003c/td\u003e\n\u003c/tr\u003e\n\n\u003c/table\u003e\n\n\u003c/div\u003e\n\n## 📬 Contact Details\n\nYou can connect with me on various platforms:\u003cbr\u003e\n[![LinkedIn](https://img.shields.io/badge/LinkedIn-%230077B5.svg?logo=linkedin\u0026logoColor=white)](https://linkedin.com/in/sugam-arora-117265142) [![Instagram](https://img.shields.io/badge/Instagram-%23E4405F.svg?logo=Instagram\u0026logoColor=white)](https://instagram.com/sugam.arora.393?utm_source=qr\u0026igshid=MzNlNGNkZWQ4Mg%3D%3D) [![Twitter](https://img.shields.io/badge/Twitter-%231DA1F2.svg?logo=Twitter\u0026logoColor=white)](https://twitter.com/SugamArora14) [![Facebook](https://img.shields.io/badge/Facebook-%231877F2.svg?logo=Facebook\u0026logoColor=white)](https://facebook.com/sugam.arora.393)[![YouTube](https://img.shields.io/badge/YouTube-%23FF0000.svg?logo=YouTube\u0026logoColor=white)](https://youtube.com/@sugamarora5997)\n[![Gmail](https://img.shields.io/badge/Gmail-%23FFFFFF.svg?logo=gmail\u0026logoColor=red)](mailto:sugam.arora23@gmail.com)\n\n🎯 **Transform customer insights into business success with RFM Analysis Dashboard!** 🚀  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsugam-arora%2Frfm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsugam-arora%2Frfm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsugam-arora%2Frfm/lists"}