Image Threat Scanner 🖼️

A professional web application that detects malicious content hidden within image files using the FALCONS.AI Image Threat Scanner API.

🚨 Overview

Image Threat Scanner provides enterprise-grade security analysis for image files, detecting hidden threats that traditional antivirus software often misses.

Key Threats Detected:

• Malware embedded in image metadata
• Steganography (data hidden in pixels)
• Command injection attempts
• Phishing payloads

---

🛠️ Features

• Real-time Analysis - Instant threat detection
• Multi-Format Support - JPG, JPEG, PNG
• Professional UI - Clean Streamlit interface
• Enterprise Security - Powered by FALCONS.AI

---

⚡ Quick Start

# 1. Clone repository
git clone https://github.com/omar-steam/image-threat-scanner.git
cd image-threat-scanner

# 2. Install dependencies
pip install -r requirements.txt

# 3. Add API key to .env file
echo "RAPID_API_KEY=your_falcons_ai_api_key_here" > .env

# 4. Run application
streamlit run app.py

---

🎯 Usage

1. Upload an image file (JPG/JPEG/PNG)
2. Click "Scan for Malicious Content"
3. View security analysis results

---

🔧 API Setup

1. Sign up at RapidAPI FALCONS.AI
2. Subscribe to Image Threat Scanner API
3. Copy API key to .env file

---

📁 Project Structure

image-threat-scanner/
├── app.py
├── requirements.txt
├── .env
├── README.md

---

📊 Example Output

Safe Image:

✅ Status: No Threats
File: profile.jpg (2.1 MB)
Type: image/jpeg

Threat Detected:

Status: Threat Detected  
File: suspicious_image.png (8.5 MB)
Signature: Trojan.Emotet.Generic

---

🔗 Links

• FALCONS.AI API
• Streamlit Documentation

---

📝 Requirements

streamlit>=1.28.0
requests>=2.31.0
python-dotenv>=1.0.0
Pillow>=10.0.0

---

🔒 Security Notes

• Never commit your .env file to version control
• Add .env to your .gitignore file
• Keep your API key confidential
• Regularly update dependencies for security patches

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

---

⭐ Show your support

Give a ⭐️ if this project helped you!