🚀 SpamGuardian AI — Enterprise Email Spam Classifier

A production-ready AI-powered spam detection platform built with modern frontend architecture and secure serverless inference.

SpamGuardian analyzes raw email content using advanced machine learning techniques and Gemini-powered intelligence to accurately classify malicious or safe messages — all while maintaining a privacy-first design.

🔥 Live Capabilities: ✅ Real-time AI email classification ✅ Secure API architecture (no exposed keys) ✅ Serverless inference pipeline ✅ Feature importance analysis ✅ Execution trace visualization ✅ Model telemetry metrics ✅ Privacy-first processing ✅ Modern glassmorphic UI

🏗️ Architecture Overview Client (React + Vite) ↓ Secure Serverless API ↓ Gemini AI Inference Designed to reflect real-world production patterns rather than tutorial-level implementations.

⚙️ Tech Stack

Frontend:

React + TypeScript Vite Tailwind CSS Glassmorphic UI system Framer Motion

Backend:

Serverless Functions Gemini AI API Environment-secured architecture

🔐 Security Highlights: ✅ Zero exposed secrets ✅ Environment variable protection ✅ Server-side AI requests ✅ Input validation ✅ Production-safe design

⭐ Future Improvements: Rate limiting Authentication Model switching Threat intelligence dashboard Email header analysis Fine-tuned spam model

👨‍💻 Author Built by HIMANSU SEKHAR NAYAK — focused on production-grade AI interfaces and modern web engineering.

💡 Final Note This project reflects my approach to building AI applications: Secure. Scalable. Production-minded.

Run and deploy your AI Studio app

1. Clone the repo: git clone https://github.com/YOUR_USERNAME/spamguardian-ai.git

2. Install dependencies: npm install

3. Create your environment file: .env

4. Add: GEMINI_API_KEY=your_key_here

5. Run locally:

NPM run dev

Prerequisites: Node.js