HawkEye

HawkEye is a real-time threat monitoring system that detects dangerous human activity from CCTV footage. Built with Flask, YOLOv8, and Google Gemini Vision, it automatically analyzes human movement in video files and sends email and phone alerts when suspicious behavior is detected.

📌 About the Project HawkEye focuses primarily on backend technology — combining real-time object detection, contextual AI analysis, and intelligent alerting — to build a meaningful safety solution. While a basic frontend dashboard is included for demonstration purposes, the core innovation lies in the detection and analysis pipeline.

💡 Key Features 📂 Uses YOLOv8 to detect humans and movements in CCTV-like footage (runs locally) 🎥 Live camera monitoring with real-time threat detection 🤖 Uses Google Gemini Vision to analyze screenshots for dangerous behavior (cloud API) ✉️ Sends detailed email alerts with images and structured threat logs 📞 Makes automated phone calls for critical threats (Twilio) 🔒 Supports privacy masking and multi-level threat detection 🧍‍♂️ Tracks people across multiple frames for consistency 📈 Provides advanced analytics and visual logs 📢 Supports external alarm system triggers 📁 Stores logs and reports for post-event investigation ⚙️ Backend-driven — minimal dependencies and frontend bloat

Built With

• google-generativeai
• matplotlib
• numpy
• pandas
• python
• scipy
• smtp
• yolov8