ChurnGuard — Live Customer Churn Prediction Platform | Open Source | Mopuru Upendra Reddy

LIVE · OPEN SOURCE · FREE · 2026
ChurnGuard

Customer Churn Prediction Platform

Real-time Analytics · ML Risk Scoring · Optional Claude AI Advisor · Python ML

// Stop Losing Customers. Start Predicting Churn.

⚛️ React 18 TypeScript 5 ๐Ÿ Python ML ๐Ÿค– Claude AI (optional) Node.js 24 ๐Ÿ†“ Open Source

⚠ Backend runs on Render's free tier and sleeps when idle — first request after inactivity takes 30-50s to wake up.

940
Customers in Dataset
32.1%
Churn Rate Detected
9
API Endpoints
<1s
Prediction Speed
~68%
ML Test Accuracy
$0
Cost, Forever

๐Ÿ“– The Story

Most companies have no idea a customer is about to leave until the cancellation email arrives. Tools that solve this exist — but they're typically enterprise software costing tens of thousands of dollars a year, built for teams with a data scientist on staff.

I built ChurnGuard as my own version of that idea — a full-stack, open-source churn intelligence platform. A real Python scikit-learn model, a real Node.js REST API, a real React dashboard on top of it, and an optional Claude AI advisor for plain-English retention recommendations.

It's not just code sitting in a repo. It's deployed — a live site, a live API, a live dashboard — click the links above and try it yourself.

Platform Features

๐Ÿ“Š
REAL-TIME DASHBOARD
Live KPI cards, 5 tabs, dark/light mode. Churn rate, revenue at risk, high-risk customers — all computed from the real dataset.
๐Ÿ”ฎ
ML RISK ENGINE
Scores every customer 0–100 using contract type, tenure, charges, and demographics. A weighted model, transparent and explainable.
๐Ÿค–
CLAUDE AI ADVISOR
Optional. Generates retention recommendations from live data when an Anthropic API key is set — otherwise runs in a clearly-labeled demo mode.
๐Ÿ‘ฅ
CUSTOMER REGISTRY
940 customers. Searchable, sortable, filterable, paginated. One-click CSV export.
๐Ÿ“ˆ
5 CHART TYPES
Contract, internet, payment, tenure, monthly charges — visualized with Recharts.
9 REST API ENDPOINTS
Full OpenAPI 3.1 spec, no auth required. Hit the links above right now — they return real JSON.
๐Ÿ
PYTHON ML MODEL
Standalone logistic regression, scikit-learn, ~68% test accuracy. Runs from the command line too.
๐ŸŒ™
DARK / LIGHT MODE
System-aware theme switching across every chart and card.
๐Ÿš€
ACTUALLY DEPLOYED
Frontend on Vercel, backend on Render. Not just a repo — a working link anyone can open.

๐Ÿ—บ Public Roadmap

✅ Q3 2026 — LIVE NOW
Foundation Complete — Everything Below is Live
No signup. No credit card. No limits. Open it and go.
Real-time churn analytics dashboard
ML weighted risk scoring (0–100)
Claude AI advisor (with demo-mode fallback)
9 REST API endpoints + OpenAPI spec
Python ML model (scikit-learn)
Deployed on Vercel + Render
๐Ÿ”ง Q4 2026 — COMING NEXT
Integrations & Automation
Slack & email real-time alerts
Salesforce & HubSpot CRM sync
Custom risk model training UI
PostgreSQL + Docker
Q3 2026
Live now ✅
Q4 2026
In progress ๐Ÿ”ง
2027
Planned ๐Ÿš€
Later
Ideas ๐ŸŒŸ

๐Ÿ’ก Why This Exists

๐ŸŽฏ
BUILT TO BE USEFUL
Every feature exists because a churn dashboard should help someone make a real decision — not just look good in a screenshot.
๐Ÿ”“
FREE MEANS FREE
No trial period, no feature paywall. The full dashboard, the API, and the ML model are yours to use and modify.
๐ŸŒฑ
BUILT SOLO, IN THE OPEN
One developer's project, shipped publicly. The roadmap above is real, and it updates as work actually gets done.
๐ŸŒ
Making churn intelligence
accessible, not just enterprise-priced.

Enterprise churn tools often cost $50,000/year. ChurnGuard is free and open source — built to be capable enough for a real team to rely on, and simple enough for one person to deploy in an afternoon.

API Reference

9 REST ENDPOINTS · churnguard-customer-churn-prediction.onrender.com/api/churn

GET /summaryChurn rate, avg charges, tenure, senior rate
GET /by-contractChurn counts by contract type
GET /by-internetChurn counts by internet service
GET /by-paymentChurn counts by payment method
GET /tenure-distributionChurn across 6 tenure buckets
GET /monthly-chargesCharges distribution
GET /customersAll 940 customers with risk scores
POST /predictPredict churn from customer attributes
POST /ai-advisorAI retention recommendations (demo mode without a key)

๐Ÿš€ Run It Yourself

1

Clone the Repository

git clone https://github.com/upendra8690/churnguard-customer-churn-prediction.git cd churnguard-customer-churn-prediction
2

Start the Backend

cd backend npm install npm run dev
3

Start the Frontend

cd frontend npm install npm run dev
4

Run the Python Model

pip install pandas scikit-learn python churn_model.py

๐Ÿ‘จ‍๐Ÿ’ป About the Builder

๐Ÿง‘‍๐Ÿ’ป
Mopuru Upendra Reddy
@upendra8690 · CSE Student · AI/ML · Cybersecurity · Data Science

Building full-stack, applied-ML projects to actually ship — not just prototype. ChurnGuard is deployed, open source, and free to use or fork.

Star It. Fork It. Use It.

Free, open source, deployed, and built to actually work — click the live links above and see for yourself.

Comments

Popular posts from this blog

๐Ÿ”ฅ Fire & Ice — Magic Hand Particle System ❄️ | Pure Python

๐ŸŽ“ I Built a Student Grade Book Web App — Python + Live Dashboard | Infosys Ed-Tech | Mopuru Upendra Reddy

๐Ÿš€ ONCO Breast Cancer Detection System (2026)