SecurityLogs-AI-Dashboard

# SecurityLogs AI Dashboard 🛡️

An open-source, AI-powered dashboard builder that accepts security logs and automatically generates charts, KPIs, trends, and executive summaries. Built specifically for cybersecurity professionals who need instant visibility into raw data.

---

## 📸 Screenshots

### Initial Application Interface
![Dashboard Landing Page](screenshots/interface.png)

### Dashboard Analysis Views
<table>
  <tr>
    <td align="center" width="50%">
      <strong>CSV Log Analysis</strong><br/><br/>
      <img src="screenshots/sample_csv.png" alt="CSV Log Analysis" />
    </td>
    <td align="center" width="50%">
      <strong>JSON Log Analysis</strong><br/><br/>
      <img src="screenshots/sample_json.png" alt="JSON Log Analysis" />
    </td>
  </tr>
</table>

---

## Features
- **Plug & Play Logs:** Drop in any standard security log file (`.csv` or `.json`).
- **Automated KPIs:** Instantly calculates total events, critical alerts, and unique source endpoints.
- **Interactive Visualizations:** Generates time-series charts, severity distributions, and top-attacker maps using Plotly.
- **AI Executive Summary:** Integrates with the Google Gemini API (`gemini-3.6-flash`) to analyze data metrics and generate professional, C-level threat summaries.

---

## Expected Log Format
While the application will attempt to parse any data, for optimal visualization, ensure your logs contain some or all of these standard headers (case-insensitive):
```text
timestamp, source_ip, event_type, severity, description

```

---

## 🛠️ Installation & Testing Guide

### 1. Clone the Repository

```bash
git clone https://github.com/JuttSahib1999/SecurityLogs-AI-Dashboard.git
cd SecurityLogs-AI-Dashboard

```

### 2. Create and Activate Virtual Environment (Windows 10)

Using Python 3.13 or 3.14 via the Windows Launcher:

```bash
# For Python 3.13
py -3.13 -m venv venv

# Activate Virtual Environment
.\venv\Scripts\activate

```

### 3. Install Dependencies

```bash
pip install -r requirements.txt

```

### 4. Run the Application

```bash
streamlit run app.py

```

---

## Author

**Abdul Muqeet Tabraiz**

* [LinkedIn Profile](https://www.linkedin.com/in/abdul-muqeet-tabraiz/)
* [GitHub Profile](https://github.com/JuttSahib1999)

## License

This project is licensed under the MIT License - see the **LICENSE** file for details.

## Version

`v1.0.0`
README.md
