README.md

---
title: AI Medicare Advantage Analyzer
emoji: 🧠
colorFrom: blue
colorTo: yellow
sdk: gradio
python_version: 3.10.0
app_file: app.py
pinned: true
license: mit
cover_image: mylogo.JPG
sdk_version: 5.25.0
---

# AI Medicare Advantage Analyzer 🧠📊

**Built by PDS – Healthcare Analytics Powered by AI**

This Hugging Face Space analyzes Medicare Advantage patient data using CMS/HEDIS rules,
identifies care gaps, estimates financial recovery, and generates personalized summaries
using an embedded local LLM.

## 🚀 Features
- HEDIS & STAR care gap detection (e.g. Breast Cancer, A1c, BP)
- SDOH-aware financial forecasting with HCC logic
- LLM-generated summaries with prompt engineering
- Cohort insights dashboard: risk, gap frequency, revenue
- ZIP export of docx reports

## 📂 How to Use
1. Upload a CSV with synthetic or de-identified patient records.
2. Select report tone & optional custom summary prompt.
3. View reports, download ZIP, and explore population-level visuals.

## 🧠 Powered By
- Python · Gradio · Pandas · Matplotlib · Seaborn
- `llama-cpp-python` with DeepCogito LLM (8B GGUF)