Churn Risk Scoring API for Telecom Subscriber Retention
Marketing and retention systems at telecom companies increasingly need churn intelligence delivered as a service: a CRM or campaign tool calls an API with a subscriber profile and gets back a risk score in milliseconds. This project focuses on building exactly that production-style inference backend, rather than a notebook that never leaves the data science team. The intern trains an XGBoost churn model in Python and wraps it in a FastAPI service with dedicated endpoints for single and batch predictions plus a model explanation endpoint powered by SHAP, so consuming systems can retrieve both a score and its top contributing factors. Request and response schemas are validated with typed models, and the automatically generated Swagger UI makes every endpoint testable from the browser. The service is containerized with Docker and deployed to Hugging Face Spaces, giving the intern a live, shareable URL for their working API. The project teaches the machine learning engineering side of data science: serializing and versioning models, designing inference APIs, documenting them for other developers, and shipping a containerized service to a public host — the skills that separate deployable work from experiments.
Related projects
You might also like