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 📽 Intended Use HawkEye is designed to run locally on systems such as:

Schools Retail environments Residential security systems Live monitoring scenarios (using built-in or external cameras) It currently processes local video files and live camera feeds, and requires internet for AI-based analysis, but future versions will support offline AI models for complete local operation.

Built With

• flask
• generative-ai
• numpy
• pandas
• yolov8