Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
|
@@ -22,6 +22,15 @@ short_description: Data-Driven Innovation for Aadhaar
|
|
| 22 |
|
| 23 |
---
|
| 24 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 25 |
## π― Overview
|
| 26 |
|
| 27 |
Project Sentinel is an innovative fraud detection system designed specifically for UIDAI Aadhaar enrolment centers. Unlike traditional global threshold-based systems, Sentinel uses **context-aware machine learning** with district-level normalization to identify fraudulent patterns while accounting for India's demographic diversity.
|
|
@@ -69,6 +78,15 @@ India's demographic diversity creates a unique challenge:
|
|
| 69 |
|
| 70 |
## π Quick Start
|
| 71 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 72 |
### Prerequisites
|
| 73 |
```bash
|
| 74 |
Python 3.8+
|
|
@@ -79,7 +97,7 @@ pip (Python package manager)
|
|
| 79 |
|
| 80 |
1. **Clone the repository**
|
| 81 |
```bash
|
| 82 |
-
git clone https://huggingface.co/spaces/
|
| 83 |
cd UIDAI
|
| 84 |
```
|
| 85 |
|
|
@@ -114,8 +132,8 @@ UIDAI/
|
|
| 114 |
βββ requirements.txt # Python dependencies
|
| 115 |
βββ Dockerfile # Docker configuration
|
| 116 |
βββ project_sentinel_notebook.ipynb # ML model & data processing
|
| 117 |
-
βββ
|
| 118 |
-
βββ analyzed_aadhaar_data.csv
|
| 119 |
βββ docs/
|
| 120 |
β βββ Project_Sentinel_Analysis.docx
|
| 121 |
β βββ Sentinel_Dashboard_Documentation.docx
|
|
@@ -374,8 +392,8 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
|
|
| 374 |
## π§ Contact
|
| 375 |
|
| 376 |
For questions or support, please contact:
|
| 377 |
-
- **Email**:
|
| 378 |
-
- **Issues**: [GitHub Issues](https://github.com/
|
| 379 |
- **Discussions**: [GitHub Discussions](https://github.com/lovnishverma/UIDAI/discussions)
|
| 380 |
|
| 381 |
---
|
|
|
|
| 22 |
|
| 23 |
---
|
| 24 |
|
| 25 |
+
## π― Quick Links
|
| 26 |
+
|
| 27 |
+
- **π Live Notebook**: [Open in Google Colab](https://colab.research.google.com/drive/1YAQ4nfxltvG_cts3fmGc_zi2JQc4oPOT?usp=sharing)
|
| 28 |
+
- **π Dashboard Demo**: [Hugging Face Spaces](https://huggingface.co/spaces/lovnishverma/UIDAI)
|
| 29 |
+
- **π Documentation**: See `/docs` folder
|
| 30 |
+
- **π» Source Code**: Available in this repository
|
| 31 |
+
|
| 32 |
+
---
|
| 33 |
+
|
| 34 |
## π― Overview
|
| 35 |
|
| 36 |
Project Sentinel is an innovative fraud detection system designed specifically for UIDAI Aadhaar enrolment centers. Unlike traditional global threshold-based systems, Sentinel uses **context-aware machine learning** with district-level normalization to identify fraudulent patterns while accounting for India's demographic diversity.
|
|
|
|
| 78 |
|
| 79 |
## π Quick Start
|
| 80 |
|
| 81 |
+
### **Option 1: Google Colab (Fastest)**
|
| 82 |
+
Run the complete analysis in your browser without any setup:
|
| 83 |
+
|
| 84 |
+
[](https://colab.research.google.com/drive/1YAQ4nfxltvG_cts3fmGc_zi2JQc4oPOT?usp=sharing)
|
| 85 |
+
|
| 86 |
+
Click the badge above to open the notebook and run all cells to generate the analyzed data.
|
| 87 |
+
|
| 88 |
+
### **Option 2: Local Setup**
|
| 89 |
+
|
| 90 |
### Prerequisites
|
| 91 |
```bash
|
| 92 |
Python 3.8+
|
|
|
|
| 97 |
|
| 98 |
1. **Clone the repository**
|
| 99 |
```bash
|
| 100 |
+
git clone https://huggingface.co/spaces/lovnishverma/UIDAI
|
| 101 |
cd UIDAI
|
| 102 |
```
|
| 103 |
|
|
|
|
| 132 |
βββ requirements.txt # Python dependencies
|
| 133 |
βββ Dockerfile # Docker configuration
|
| 134 |
βββ project_sentinel_notebook.ipynb # ML model & data processing
|
| 135 |
+
βββ app.py # Streamlit dashboard
|
| 136 |
+
βββ analyzed_aadhaar_data.csv # Processed data (generated from colab)
|
| 137 |
βββ docs/
|
| 138 |
β βββ Project_Sentinel_Analysis.docx
|
| 139 |
β βββ Sentinel_Dashboard_Documentation.docx
|
|
|
|
| 392 |
## π§ Contact
|
| 393 |
|
| 394 |
For questions or support, please contact:
|
| 395 |
+
- **Email**: sentinel-support@example.com
|
| 396 |
+
- **Issues**: [GitHub Issues](https://github.com/lovnnishverma/UIDAI/issues)
|
| 397 |
- **Discussions**: [GitHub Discussions](https://github.com/lovnishverma/UIDAI/discussions)
|
| 398 |
|
| 399 |
---
|