scorecard-package 1.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Sanket Shrishrimal
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,7 @@
1
+ include README.md
2
+ include LICENSE
3
+ include requirements.txt
4
+ recursive-include Scorecard_Package *.py
5
+ recursive-include Scorecard_Package *.xlsx
6
+ recursive-include Scorecard_Package *.csv
7
+ recursive-include Scorecard_Package *.json
@@ -0,0 +1,457 @@
1
+ Metadata-Version: 2.4
2
+ Name: scorecard-package
3
+ Version: 1.0.0
4
+ Summary: Python framework for credit risk scorecard development, validation, deployment and monitoring.
5
+ Home-page: https://github.com/sanket-shrishrimal/Scorecard-Package
6
+ Download-URL: https://github.com/sanket-shrishrimal/Scorecard-Package/archive/refs/tags/v1.0.0.tar.gz
7
+ Author: Sanket Shrishrimal
8
+ Author-email: shrishrimalsanket@gmail.com
9
+ License: MIT
10
+ Project-URL: Documentation, https://github.com/sanket-shrishrimal/Scorecard-Package
11
+ Project-URL: Source, https://github.com/sanket-shrishrimal/Scorecard-Package
12
+ Project-URL: Issues, https://github.com/sanket-shrishrimal/Scorecard-Package/issues
13
+ Keywords: credit risk,credit scorecard,scorecard development,credit scoring,woe,information value,logistic regression,weighted logistic regression,vif,stepwise regression,psi,csi,model validation,credit modelling,risk modelling,banking,nbfc,fintech
14
+ Classifier: Development Status :: 4 - Beta
15
+ Classifier: Intended Audience :: Financial and Insurance Industry
16
+ Classifier: Intended Audience :: Developers
17
+ Classifier: Intended Audience :: Science/Research
18
+ Classifier: Programming Language :: Python :: 3
19
+ Classifier: Programming Language :: Python :: 3.9
20
+ Classifier: Programming Language :: Python :: 3.10
21
+ Classifier: Programming Language :: Python :: 3.11
22
+ Classifier: Programming Language :: Python :: 3.12
23
+ Classifier: Programming Language :: Python :: 3 :: Only
24
+ Classifier: License :: OSI Approved :: MIT License
25
+ Classifier: Operating System :: OS Independent
26
+ Classifier: Topic :: Scientific/Engineering
27
+ Classifier: Topic :: Office/Business :: Financial
28
+ Classifier: Topic :: Scientific/Engineering :: Information Analysis
29
+ Requires-Python: >=3.9
30
+ Description-Content-Type: text/markdown
31
+ License-File: LICENSE
32
+ Requires-Dist: numpy>=1.22
33
+ Requires-Dist: pandas>=1.5
34
+ Requires-Dist: scipy>=1.9
35
+ Requires-Dist: statsmodels>=0.13
36
+ Requires-Dist: scikit-learn>=1.2
37
+ Requires-Dist: matplotlib>=3.6
38
+ Requires-Dist: openpyxl>=3.0
39
+ Requires-Dist: joblib>=1.2
40
+ Dynamic: author
41
+ Dynamic: author-email
42
+ Dynamic: classifier
43
+ Dynamic: description
44
+ Dynamic: description-content-type
45
+ Dynamic: download-url
46
+ Dynamic: home-page
47
+ Dynamic: keywords
48
+ Dynamic: license
49
+ Dynamic: license-file
50
+ Dynamic: project-url
51
+ Dynamic: requires-dist
52
+ Dynamic: requires-python
53
+ Dynamic: summary
54
+
55
+ # Scorecard Package
56
+
57
+ Python 3.9+
58
+
59
+ Version 1.0.0
60
+
61
+ MIT License
62
+
63
+
64
+ PyPI
65
+
66
+ > Enterprise Credit Risk Scorecard Development Framework
67
+
68
+ Develop production-ready credit risk scorecards using industry-standard methodologies including Fine Classing (automatic fine binning) and Coarse Classing (user-controlled bin merging), WOE, IV, CSI, Correlation Analysis, VIF, Stepwise Logistic Regression, Logistic Regression, Weighted Logistic Regression, KS, GINI, Score Calibration, PSI, Validation and Deployment.
69
+
70
+ A comprehensive Python package for developing, validating, deploying and monitoring credit risk scorecards using industry-standard methodologies such as **WOE, IV, KS, Logistic Regression, Weighted Logistic Regression, PSI and CSI**.
71
+
72
+ ---
73
+
74
+ ## Overview
75
+
76
+ Scorecard Package provides an end-to-end framework for building production-ready credit risk scorecards.
77
+
78
+ The package automates the complete scorecard development lifecycle including:
79
+
80
+ ### Data Preparation
81
+
82
+ - Fine Classing
83
+ - Coarse Classing
84
+ - Rule Management
85
+
86
+ ### Feature Engineering
87
+
88
+ - WOE
89
+ - IV
90
+ - KS
91
+
92
+ ### Model Development
93
+
94
+ - Correlation Analysis
95
+ - VIF
96
+ - Stepwise Regression
97
+ - Logistic Regression
98
+ - Weighted Logistic Regression
99
+
100
+ ### Validation & Monitoring
101
+
102
+ - PSI
103
+ - CSI
104
+ - Deployment
105
+
106
+ Designed for:
107
+
108
+ - Banks
109
+ - NBFCs
110
+ - FinTech Companies
111
+ - Credit Risk Analysts
112
+ - Data Scientists
113
+ - Model Validation Teams
114
+
115
+ ---
116
+
117
+ # Features
118
+
119
+ ✅ Fine Classing
120
+
121
+ ✅ Coarse Classing
122
+
123
+ ✅ Automatic WOE Transformation
124
+
125
+ ✅ Information Value (IV)
126
+
127
+ ✅ KS Calculation
128
+
129
+ ✅ Variable Bivariate Reports
130
+
131
+ ✅ Correlation Analysis
132
+
133
+ ✅ VIF Filtering
134
+
135
+ ✅ Stepwise Regression
136
+
137
+ ✅ Logistic Regression
138
+
139
+ ✅ Weighted Logistic Regression
140
+
141
+ ✅ Score Calibration
142
+
143
+ ✅ Scorecard Generation
144
+
145
+ ✅ Automatic Score Banding
146
+
147
+ ✅ Model Validation
148
+
149
+ ✅ Deployment Framework
150
+
151
+ ✅ PSI Monitoring
152
+
153
+ ✅ CSI Monitoring
154
+
155
+ ✅ Export to Excel / CSV
156
+
157
+ ---
158
+
159
+ # Installation
160
+
161
+ ```bash
162
+ pip install scorecard-package
163
+ ```
164
+
165
+ Import the package:
166
+
167
+ ```python
168
+ import Scorecard_Package as sp
169
+ ```
170
+
171
+ or install directly from GitHub
172
+
173
+ ```bash
174
+ pip install git+https://github.com/sanket-shrishrimal/Scorecard-Package.git
175
+ ```
176
+
177
+ ---
178
+
179
+ # Requirements
180
+
181
+ - Python 3.9+
182
+ - NumPy
183
+ - Pandas
184
+ - SciPy
185
+ - Statsmodels
186
+ - Scikit-learn
187
+ - OpenPyXL
188
+ - Matplotlib
189
+ - Joblib
190
+
191
+ ---
192
+
193
+ # Package Structure
194
+
195
+ ```
196
+ Scorecard_Package
197
+
198
+ ├── Fine_Classing.py
199
+ ├── Coarse_Classing.py
200
+ ├── Binning_Rules.py
201
+ ├── Modelling.py
202
+ ├── Validation.py
203
+ └── CSI.py
204
+ ```
205
+
206
+ ---
207
+
208
+ # Workflow
209
+
210
+ ```
211
+ Raw Data
212
+
213
+
214
+ Fine Classing
215
+
216
+
217
+ Coarse Classing
218
+
219
+
220
+ WOE Transformation
221
+
222
+
223
+ Correlation Analysis
224
+
225
+
226
+ VIF Filtering
227
+
228
+
229
+ Stepwise Selection
230
+
231
+
232
+ Logistic Regression
233
+
234
+
235
+ Score Calibration
236
+
237
+
238
+ Validation
239
+
240
+
241
+ Deployment
242
+
243
+
244
+ PSI / CSI Monitoring
245
+ ```
246
+
247
+ ---
248
+
249
+ # Quick Start
250
+
251
+ ```python
252
+ import Scorecard_Package as sp
253
+ ```
254
+
255
+ ### Fine Classing
256
+
257
+ ```python
258
+ import Scorecard_Package as sp
259
+
260
+ summary, bivariates, rules = sp.fine_classing(
261
+ df=train_df,
262
+ target="Default",
263
+ ...
264
+ )
265
+ ```
266
+
267
+ ### Coarse Classing
268
+
269
+ ```python
270
+ summary,bivariates,rules=sp.coarse_classing(...)
271
+ ```
272
+
273
+ ### Model Development
274
+
275
+ ```python
276
+ results=sp.scorecard_model_pipeline(...)
277
+ ```
278
+
279
+ ### Validation
280
+
281
+ ```python
282
+ results=sp.deploy_model(...)
283
+ ```
284
+
285
+ ### CSI
286
+
287
+ ```python
288
+ csi_report=sp.calculate_csi(...)
289
+ ```
290
+
291
+ ---
292
+
293
+ # Main Modules
294
+
295
+ ## Fine_Classing
296
+
297
+ Automatic fine bin creation with:
298
+
299
+ - IV
300
+ - KS
301
+ - WOE
302
+ - Bivariate Reports
303
+ - Fine Rules
304
+
305
+ ---
306
+
307
+ ## Coarse_Classing
308
+
309
+ Automatic and manual bin merging.
310
+
311
+ Outputs:
312
+
313
+ - Coarse Rules
314
+ - WOE
315
+ - IV
316
+ - KS
317
+ - Monotonicity
318
+
319
+ ---
320
+
321
+ ## Modelling
322
+
323
+ Complete scorecard development pipeline.
324
+
325
+ Includes:
326
+
327
+ - Correlation Analysis
328
+ - VIF
329
+ - Stepwise Selection
330
+ - Logistic Regression
331
+ - Weighted Logistic Regression
332
+ - Score Calibration
333
+ - Scorecard Generation
334
+
335
+ ---
336
+
337
+ ## Validation
338
+
339
+ Production scoring module.
340
+
341
+ Automatically performs:
342
+
343
+ - Rule Loading
344
+ - WOE Transformation
345
+ - PD Prediction
346
+ - Score Generation
347
+ - Band Assignment
348
+ - PSI Calculation
349
+
350
+ ---
351
+
352
+ ## CSI
353
+
354
+ Characteristic Stability Index calculation.
355
+
356
+ Supports:
357
+
358
+ - Development vs Validation comparison
359
+ - Stability Reports
360
+ - Excel Export
361
+
362
+ ---
363
+
364
+ # Outputs
365
+
366
+ The package automatically generates:
367
+
368
+ | Module | Output |
369
+ | --------------- | -------------------------- |
370
+ | Fine Classing | Summary, Bivariates, Rules |
371
+ | Coarse Classing | Summary, Rules |
372
+ | Modelling | Model, Scorecard, Metrics |
373
+ | Validation | Validation Report |
374
+ | CSI | CSI Report |
375
+
376
+
377
+ ---
378
+
379
+ ## Why Scorecard Package?
380
+
381
+ Unlike generic machine learning libraries, Scorecard Package provides an end-to-end implementation of the complete credit scorecard lifecycle used across banks, NBFCs and financial institutions. The framework focuses on transparency, reproducibility and production-ready deployment rather than black-box modelling.
382
+
383
+ - End-to-end workflow
384
+ - Industry-standard methodology
385
+ - Transparent calculations
386
+ - Reusable rule engine
387
+ - Production deployment support
388
+ - Excel and CSV exports
389
+ - No hidden black-box modeling
390
+
391
+ ---
392
+
393
+ # Documentation
394
+
395
+ A comprehensive User Guide with detailed examples and case studies is currently under development.
396
+
397
+ ---
398
+
399
+ ## Upcoming Features
400
+
401
+ - Reject Inferencing
402
+ - SHAP-based Model Explainability
403
+ - Model Monitoring Dashboard
404
+ - Interactive HTML Reports
405
+ - Automated Documentation
406
+ - Population Drift Reports
407
+ - Hyperparameter Optimization
408
+
409
+ ---
410
+
411
+ # Version
412
+
413
+ Current Version
414
+
415
+ ```
416
+ 1.0.0
417
+ ```
418
+
419
+ ---
420
+
421
+ # Author
422
+
423
+ **Sanket Shrishrimal**
424
+
425
+ Credit Risk & Analytics Consultant
426
+
427
+ Mumbai, India
428
+
429
+ ---
430
+
431
+ # License
432
+
433
+ MIT License
434
+
435
+ ---
436
+
437
+ # Contributing
438
+
439
+ Contributions, feature requests and bug reports are welcome.
440
+
441
+ Please create an Issue or Pull Request.
442
+
443
+ ---
444
+
445
+ # Contact
446
+
447
+ For questions, feature requests or collaboration:
448
+
449
+ **Email**
450
+
451
+ shrishrimalsanket@gmail.com
452
+
453
+ ---
454
+
455
+ # Acknowledgements
456
+
457
+ This package was developed to simplify and standardize enterprise credit scorecard development while remaining fully transparent and customizable for production use.