Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
@@ -11,7 +11,6 @@ pinned: false
|
|
11 |
|
12 |
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
13 |
|
14 |
-
|
15 |
# Smart Loan Recovery System
|
16 |
|
17 |
A machine learning-powered system for predicting loan recovery probability with a Streamlit web interface.
|
@@ -20,6 +19,19 @@ A machine learning-powered system for predicting loan recovery probability with
|
|
20 |
|
21 |
The Smart Loan Recovery System helps financial institutions predict the likelihood of recovering loans by analyzing various customer and loan attributes. The system uses machine learning algorithms to provide insights that can help prioritize collection efforts and optimize recovery strategies.
|
22 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
23 |
## Features
|
24 |
|
25 |
- **Predictive Analytics**: Uses machine learning to predict loan recovery probability
|
@@ -63,20 +75,29 @@ streamlit run app.py
|
|
63 |
|
64 |
```
|
65 |
smart-loan-recovery-system/
|
66 |
-
βββ app.py
|
67 |
-
βββ data/
|
68 |
-
β βββ loan_data.csv
|
69 |
-
βββ models/
|
70 |
-
βββ
|
71 |
-
β
|
72 |
-
|
73 |
-
β βββ
|
74 |
-
β
|
75 |
-
β βββ
|
76 |
-
β
|
77 |
-
β βββ
|
78 |
-
βββ
|
79 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
80 |
```
|
81 |
|
82 |
## Machine Learning Model
|
@@ -91,11 +112,11 @@ The Streamlit web interface focuses solely on loan recovery prediction, providin
|
|
91 |
|
92 |
### Sample Interface
|
93 |
|
94 |
-

|
25 |
+
|
26 |
+
The diagram above illustrates the complete workflow of the Smart Loan Recovery System:
|
27 |
+
|
28 |
+
1. **Data Input**: Users can enter individual loan details or upload CSV files for batch processing
|
29 |
+
2. **Data Processing**: The system preprocesses the data, performs feature engineering and normalization
|
30 |
+
3. **Random Forest Model**: The prediction engine analyzes the data using the Random Forest algorithm
|
31 |
+
4. **Results Visualization**: Interactive charts display recovery probability and risk assessment
|
32 |
+
|
33 |
+
The bottom section shows the key system components and their relationships, providing a clear overview of the system architecture.
|
34 |
+
|
35 |
## Features
|
36 |
|
37 |
- **Predictive Analytics**: Uses machine learning to predict loan recovery probability
|
|
|
75 |
|
76 |
```
|
77 |
smart-loan-recovery-system/
|
78 |
+
βββ app.py # Main Streamlit application
|
79 |
+
βββ data/ # Data directory
|
80 |
+
β βββ loan_data.csv # Sample loan data
|
81 |
+
βββ models/ # Trained models
|
82 |
+
β βββ loan_recovery_random_forest.pkl # Trained Random Forest model
|
83 |
+
β βββ loan_recovery_random_forest_processor.pkl # Model preprocessor
|
84 |
+
βββ screenshots/ # Screenshots and diagrams
|
85 |
+
β βββ system_workflow.svg # System workflow diagram (SVG)
|
86 |
+
β βββ system_workflow.png # System workflow diagram (PNG)
|
87 |
+
β βββ system_workflow.html # System workflow diagram (HTML)
|
88 |
+
β βββ loan_input_form.png # UI screenshot - input form
|
89 |
+
β βββ prediction_results.png # UI screenshot - results
|
90 |
+
βββ src/ # Source code
|
91 |
+
β βββ models/ # ML model implementations
|
92 |
+
β β βββ loan_recovery_model.py # Loan recovery model class
|
93 |
+
β βββ preprocessing/ # Data preprocessing
|
94 |
+
β β βββ data_processor.py # Data processor class
|
95 |
+
β βββ utils/ # Utility functions
|
96 |
+
β β βββ data_generator.py # Synthetic data generator
|
97 |
+
β βββ train_model.py # Script to train models
|
98 |
+
βββ Smart_Loan_Recovery_System_Documentation.docx # Comprehensive project documentation
|
99 |
+
βββ README.md # Project overview
|
100 |
+
βββ requirements.txt # Project dependencies
|
101 |
```
|
102 |
|
103 |
## Machine Learning Model
|
|
|
112 |
|
113 |
### Sample Interface
|
114 |
|
115 |
+

|
116 |
|
117 |
### Sample Results
|
118 |
|
119 |
+

|
120 |
|
121 |
The interface allows users to:
|
122 |
- Enter individual loan details with comprehensive input fields
|