Update README.md

README.md

@@ -10,3 +10,24 @@ pinned: false
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# 🛡️ Enterprise Email Security Analyzer
+
+A Gradio web app that classifies and evaluates email content for **spam**, **phishing**, and **malware-style indicators** using an ensemble ML model plus rule-based threat intelligence.
+
+## 🚀 Features
+- **Ensemble ML Engine:** Naïve Bayes + Logistic Regression  
+- **Threat Intelligence:** 5 categories of phishing/social-engineering patterns  
+- **Deep URL Inspection:** detects IP-based, shortener, punycode, and malicious TLDs  
+- **Behavioral Scoring:** urgency, financial terms, capitalization abuse, domain mismatches  
+- **Comprehensive Report:** ML confidence, risk level, and mitigation guidance  
+- **Persistent Logs:** `saved_spam_emails.csv` and `analysis_history.csv`
+
+## 🧠 Tech Stack
+Python • scikit-learn • Gradio • Pandas • Joblib
+
+## ▶️ Run Locally
+```bash
+pip install -r requirements.txt
+python app.py
+