Spaces:
Sleeping
Sleeping
|
Download README.md from StillWorking/Dep-Sight: direct link, hf CLI and curl.
- Browser
- Download file 2.87 kB
-
https://huggingface.co/spaces/StillWorking/Dep-Sight/resolve/main/README.md
- Command line
-
hf download hf://spaces/StillWorking/Dep-Sight/README.md
-
curl -L -o README.md https://huggingface.co/spaces/StillWorking/Dep-Sight/resolve/main/README.md
2.87 kB
| title: Deep Sight | |
| emoji: π | |
| colorFrom: blue | |
| colorTo: pink | |
| sdk: docker | |
| app_file: app.py | |
| pinned: false | |
| # DeepSight EWS - Loan Default Prediction System | |
| **IDBI Bank Innovation 2026** - Early Warning System for Loan Defaults | |
| This is a FastAPI-based backend deployed on Hugging Face Spaces that provides loan default prediction capabilities using a dual-branch machine learning model combining structured financial data and NLP-based narrative analysis. | |
| ## π Features | |
| - **Portfolio Summary**: Real-time overview of loan portfolio health | |
| - **High-Risk Alerts**: Identification of borrowers with high probability of default (PD > 0.65) | |
| - **Borrower Explanations**: Detailed SHAP-based explanations showing which features drive risk | |
| - **Loan Prediction API**: Make predictions for new loan applications | |
| - **SHAP Visualizations**: Global feature importance and individual borrower waterfalls | |
| ## π Model Architecture | |
| The DeepSight model uses a **dual-branch architecture**: | |
| ### Branch A: Structured Financial Data | |
| - Loan amount, interest rate, DTI ratio | |
| - Annual income, FICO score | |
| - Credit history metrics (open accounts, delinquencies) | |
| - Employment length, revolving utilization | |
| ### Branch B: NLP Narrative Analysis | |
| - Borrower narrative text processing | |
| - FinBERT sentiment analysis (positive, negative, neutral) | |
| - Distress indicators from loan descriptions | |
| - Combined text features (title + description + purpose) | |
| ## π§ API Endpoints | |
| ### Health Check | |
| ```bash | |
| GET / | |
| GET /health | |
| ``` | |
| ### Portfolio Management | |
| ```bash | |
| GET /api/portfolio/summary | |
| # Returns: total loans, high-risk alerts, portfolio health score | |
| GET /api/borrowers/alerts?limit=50 | |
| # Returns: List of high-risk borrowers with PD scores | |
| GET /api/borrowers/{borrower_id}/explain | |
| # Returns: Detailed explanation with SHAP visualization | |
| ``` | |
| ### Predictions | |
| ```bash | |
| POST /api/predict | |
| # Body: { | |
| # "loan_amnt": 15000, | |
| # "int_rate": 14.5, | |
| # "dti": 22.5, | |
| # "annual_inc": 65000, | |
| # "installment": 425, | |
| # "fico_score": 680, | |
| # "open_acc": 12, | |
| # "delinq_2yrs": 1 | |
| # } | |
| # Returns: Probability of default and risk category | |
| ``` | |
| ## π API Documentation | |
| Once deployed, interactive API documentation is available at: | |
| - Swagger UI: `/docs` | |
| - ReDoc: `/redoc` | |
| ## π Model Performance | |
| - **Architecture**: LightGBM with dual-branch input | |
| - **Training Data**: 2.2M+ loans from LendingClub (2007-2018) | |
| - **Features**: 150+ engineered features (structured + NLP) | |
| - **Explainability**: SHAP values for model interpretability | |
| ## π οΈ Technology Stack | |
| - **Framework**: FastAPI 0.109.0 | |
| - **ML Libraries**: scikit-learn, LightGBM, XGBoost | |
| - **Data Processing**: pandas, numpy | |
| - **Explainability**: SHAP 0.44.1 | |
| - **Server**: Uvicorn with ASGI | |
| --- | |
| **Deployed with β€οΈ on Hugging Face Spaces** | |