🛡️ Inspiration
With the rapid growth of digital communication, phishing attacks, scams, and social engineering techniques have become more sophisticated and harder to detect. Many users—especially students and non-technical individuals—struggle to distinguish between legitimate and malicious messages.
The idea behind AI Guardian was to build a simple yet powerful tool that can act as a “first line of defense,” helping users instantly analyze suspicious content and understand why it might be dangerous. The goal was not just detection, but also awareness and education.
🤖 What it does
AI Guardian is a smart threat detection web application that analyzes text, URLs, and messages to identify potential cybersecurity risks.
It can:
- 🔍 Detect phishing, scams, and manipulation tactics
- 🧠 Use AI models (OpenAI / HuggingFace) for intelligent analysis
- ⚠️ Provide a risk score from 0 to 100%
- 💬 Explain the reasoning behind each detection
- 📊 Maintain a history of all scans
- 🔊 Trigger voice alerts when malicious content is detected
The detection system combines AI with a fallback heuristic engine based on keyword analysis:
[ Risk\ Score = \alpha \cdot AI_{confidence} + \beta \cdot Keyword_{weight} ]
Where ( \alpha ) and ( \beta ) balance between AI predictions and rule-based detection.
⚙️ How we built it
The project was built as a full-stack web application using a clean and modular architecture:
Frontend:
- HTML, CSS, JavaScript
- Responsive UI with Dark/Light mode
- Interactive components like risk meter and notifications
Backend:
- Node.js with Express
- RESTful API endpoints for analysis and history
AI Integration:
- OpenAI API (primary)
- HuggingFace API (fallback)
- Heuristic keyword-based engine (offline/demo mode)
Database:
- JSON-based storage (with optional MongoDB support)
Extra Features:
- Rate limiting for security
- Voice alerts using browser TTS / ElevenLabs
- Scan history tracking and statistics
⚠️ Challenges we ran into
During development, we faced several challenges:
- 🔌 API Reliability: Handling cases when AI APIs are unavailable or slow
- ⚖️ Accuracy vs Speed: Balancing fast responses with reliable threat detection
- 🧠 False Positives: Avoiding over-flagging harmless messages
- 📊 Risk Visualization: Designing a clear and intuitive risk meter
- 🔄 Fallback Logic: Ensuring the app still works without API keys
One key challenge was making the system robust enough to work in demo environments, which led to building the heuristic engine.
🏆 Accomplishments that we're proud of
- ✅ Built a fully functional AI-powered security tool in a short hackathon timeframe
- 🧩 Designed a multi-layer detection system (AI + heuristics)
- 🎨 Created a clean, responsive, and user-friendly interface
- 🔊 Implemented real-time voice alerts for malicious threats
- 📈 Developed a complete scan history and analytics system
Most importantly, the app is usable even without external APIs, making it reliable in any environment.
📚 What we learned
Through this project, we gained valuable experience in:
- 🤖 Integrating AI models into real-world applications
- 🔐 Understanding cybersecurity threats like phishing and social engineering
- ⚙️ Designing scalable backend APIs
- 🎯 Improving UX for security-focused tools
- 🧠 Combining rule-based systems with machine learning
We also learned that explainability is just as important as detection when building AI systems.
🚀 What's next for AI Guardian
We have exciting plans to take AI Guardian to the next level:
- 🌐 Browser extension for real-time protection
- 📧 Email and SMS scanning integration
- 🧠 Advanced ML models trained on real phishing datasets
- 🗣️ Multi-language support (including Arabic)
- 📊 Dashboard for organizations and teams
- 🔗 URL sandboxing and deeper link analysis
Our vision is to evolve AI Guardian into a complete personal cybersecurity assistant 🛡️
Log in or sign up for Devpost to join the conversation.