Skip to content

SIEMZello/SIEMZello-Report-Generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SIEMzello - AI Cybersecurity Log Analysis

AI-powered cybersecurity log analysis using Google Gemini AI. Analyzes security logs and generates detailed reports with threat assessment and recommendations.

Features

  • AI-powered log analysis with Google Gemini
  • JSON and PDF report generation
  • Network threat detection (DDoS, exploits, reconnaissance)
  • RESTful API with FastAPI
  • Confidence scoring and explanations

Setup

  1. Install dependencies

    pip install -r requirements.txt
  2. Configure environment Create .env file:

    GOOGLE_API_KEY=your_google_api_key
  3. Install wkhtmltopdf (for PDF generation) Download from: https://wkhtmltopdf.org/downloads.html

  4. Run the application

    python main.py

API available at http://localhost:8000

API Endpoints

POST /analyze

Analyze security logs and generate reports.

Request:

{
  "log": {
    "timestamp": "2025-01-01T10:00:00Z",
    "source_ip": "192.168.1.100",
    "dest_ip": "10.0.0.1",
    "protocol": "HTTP"
  },
  "prediction": "exploit",
  "category": "Network"
}

POST /pdf-report

Generate PDF report from log analysis (same request format as above).

POST /message

Generate concise 2-line security status message from log analysis.

Request(for exemple):

{
  "log": {
    "timestamp": "2025-01-01T10:00:00Z",
    "source_ip": "192.168.1.100",
    "dest_ip": "10.0.0.1",
    "protocol": "HTTP"
  },
  "prediction": "exploit",
  "category": "Network"
}

Response:

{
  "message": "Security Status: Critical - Network exploit detected from 192.168.1.100\nKey Alert: Block source IP immediately and investigate lateral movement"
}

Analysis Types

Network Threats: DDoS, exploits, reconnaissance, fuzzers, intrusion attempts General Analysis: Timeline reconstruction, system component identification, anomaly detection

Report Structure

  1. Threat Summary: What was detected
  2. Confidence Score: AI confidence level
  3. Threat Level: Low/Medium/High severity
  4. Recommended Actions: Specific next steps

Requirements

  • Python 3.8+
  • Google Gemini API key
  • wkhtmltopdf (for PDF generation)

About

AI powerd PDF Report Generator for threat summary

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors