Added files

README.md

@@ -1,2 +1,187 @@
-# SentinelNet
-The goal of this project is to develop an AI-powered Network Intrusion Detection System (NIDS) capable of identifying malicious network trafic and cyber-attacks in real time. By leveraging machine learning techniques, the system will classify trafic as normal or suspicious based on historical data. 
+<h1>SentinelNet – AI-Powered Network Intrusion Detection System (NIDS)</h1>
+
+<h2>📌 Project Overview</h2>
+<p>
+The goal of this project is to develop an AI-powered Network Intrusion Detection System (NIDS) capable of identifying malicious network traffic and cyber-attacks in real time.  
+By leveraging machine learning techniques, the system classifies traffic as normal or suspicious based on historical data. It processes network traffic records, extracts relevant features, trains classification models, and generates alerts for detected anomalies.
+</p>
+
+<h2>🗂️ Project Structure</h2>
+<pre>
+SENTINELNET/
+├── .venv/
+├── data/
+│   ├── DoS-Wednesday-no-metadata.parquet
+│   ├── KDDTest+.arff
+│   ├── KDDTest+.txt
+│   ├── KDDTrain+_processed.csv
+│   ├── KDDTrain+.arff
+│   ├── KDDTrain+.txt
+│   └── WebAttacks-Thursday.csv
+├── docs/
+│   └── data_overview.md
+├── notebooks/
+│   ├── attack_visualization.ipynb
+│   ├── cicids_model_train.ipynb
+│   └── nslkdd_mode_train.ipynb
+├── results/
+│   └── visual plots (PNG images)
+├── scripts/
+│   └── main.py
+├── documentation.pdf
+├── LICENSE
+├── README.md
+└── requirements.txt
+
+</pre>
+
+<h2>🎯 Objectives</h2>
+<ul>
+  <li>Understand network traffic data and common types of cyberattacks.</li>
+  <li>Apply machine learning algorithms to detect intrusions.</li>
+  <li>Build and evaluate classification models (e.g., Decision Tree, Random Forest, SVM).</li>
+  <li>Perform feature engineering and anomaly detection.</li>
+  <li>Generate alerts or logs for detected threats.</li>
+  <li>Prepare a detailed report and presentation showcasing the project.</li>
+</ul>
+
+<h2>📊 Datasets</h2>
+<p>The project uses well-known public network intrusion datasets for training and testing:</p>
+<ul>
+  <li><strong>NSL-KDD Dataset:</strong> <a href="https://www.unb.ca/cic/datasets/nsl.html" target="_blank">https://www.unb.ca/cic/datasets/nsl.html</a></li>
+  <li><strong>CICIDS2017 Dataset:</strong> <a href="https://www.unb.ca/cic/datasets/ids-2017.html" target="_blank">https://www.unb.ca/cic/datasets/ids-2017.html</a></li>
+</ul>
+
+<h2>🧩 Modules to be Implemented</h2>
+<ol>
+  <li>Dataset Acquisition and Exploration</li>
+  <li>Data Cleaning and Preprocessing</li>
+  <li>Feature Engineering and Selection</li>
+  <li>Model Building and Training</li>
+  <li>Evaluation and Performance Analysis</li>
+  <li>Alerts and Reporting</li>
+</ol>
+
+<h2>🛠️ Tech Stack</h2>
+<ul>
+  <li><strong>Language:</strong> Python</li>
+  <li><strong>Libraries:</strong> Pandas, NumPy, Matplotlib, Scikit-learn, Seaborn</li>
+</ul>
+
+<h2>🚀 Future Work</h2>
+<ul>
+  <li>Extend system to handle real-time traffic streams.</li>
+  <li>Explore deep learning models (e.g., CNN, LSTM) for improved detection.</li>
+  <li>Integrate with SIEM tools for enterprise deployment.</li>
+</ul>
+
+<h2>👥 Team Information</h2>
+<table  cellpadding="5" cellspacing="0">
+  <tr>
+    <td>Upasana Prabhakar</td>
+    <td><a href="mailto:upasanaprabhakar35@gmail.com">upasanaprabhakar35@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Bhavana Thota</td>
+    <td><a href="mailto:bhavanathota2006@gmail.com">bhavanathota2006@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Saravanan S</td>
+    <td><a href="mailto:itssaravanan03@gmail.com">itssaravanan03@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Shreyanshi Srivastava</td>
+    <td><a href="mailto:shreyanshisrivastava19@gmail.com">shreyanshisrivastava19@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Surya Sindhu Guthula</td>
+    <td><a href="mailto:22a314408.pragati@gmail.com">22a314408.pragati@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Mehak Tripathi</td>
+    <td><a href="mailto:2k22.cse.2212471@gmail.com">2k22.cse.2212471@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Amit Yadav</td>
+    <td><a href="mailto:2k23.cs2314011@gmail.com">2k23.cs2314011@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Anisetty Bhavitha</td>
+    <td><a href="mailto:bhavithaanisetty@gmail.com">bhavithaanisetty@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Prathap V</td>
+    <td><a href="mailto:vprathap0703@gmail.com">vprathap0703@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Vimala Reddy Tummuru</td>
+    <td><a href="mailto:22501a0514@pvpsit.ac.in">22501a0514@pvpsit.ac.in</a></td>
+  </tr>
+  <tr>
+    <td>Indhuja V</td>
+    <td><a href="mailto:230754.ec@rmkec.ac.in">230754.ec@rmkec.ac.in</a></td>
+  </tr>
+  <tr>
+    <td>Poornitha S</td>
+    <td><a href="mailto:240061.cs@rmkec.ac.in">240061.cs@rmkec.ac.in</a></td>
+  </tr>
+  <tr>
+    <td>Khushala Giduthuri</td>
+    <td><a href="mailto:khushaldhiagiduthuri@gmail.com">khushaldhiagiduthuri@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Bhaskar Mekala</td>
+    <td><a href="mailto:bhaskarmekala209@gmail.com">bhaskarmekala209@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Chaganti Sai Sarvani</td>
+    <td><a href="mailto:saisarvani.chaganti@gmail.com">saisarvani.chaganti@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Yasaswita</td>
+    <td><a href="mailto:yasaswita9@gmail.com">yasaswita9@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Sumithra G</td>
+    <td><a href="mailto:sumiad107@rmkec.ac.in">sumiad107@rmkec.ac.in</a></td>
+  </tr>
+  <tr>
+    <td>Sai Sathvik Balabhadra</td>
+    <td><a href="mailto:balabhadrasaisathvik@gmail.com">balabhadrasaisathvik@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Krushna Shinde</td>
+    <td><a href="mailto:krushnashinde9860@gmail.com">krushnashinde9860@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Omkar Marakwar</td>
+    <td><a href="mailto:omkarmarakwar5680@gmail.com">omkarmarakwar5680@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Vitesh Bhardwaj Mallibhat</td>
+    <td><a href="mailto:viteshbhardwaj2186@gmail.com">viteshbhardwaj2186@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Mohan Raaj C</td>
+    <td><a href="mailto:cmohanraaj0319@gmail.com">cmohanraaj0319@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Aarifa R</td>
+    <td><a href="mailto:roylamd02@gmail.com">roylamd02@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Katherine Olivia R</td>
+    <td><a href="mailto:katherineolivia.r@gmail.com">katherineolivia.r@gmail.com</a></td>
+  </tr>
+  <tr>
+    <td>Naga Lakshmi Durga Enugu</td>
+    <td><a href="mailto:24b05a1206@svcew.edu.in">24b05a1206@svcew.edu.in</a></td>
+  </tr>
+</table>
+
+<h2>📄 License</h2>
+<p>This project is licensed under the <strong>MIT License</strong></p>
+
+<blockquote style="border-left: 4px solid #28a745; padding-left: 12px; font-size:15px; margin-top: 32px;">
+  Thank you for exploring SentinelNet — together, let's build a safer digital future.
+</blockquote>