msf899/CamShield-AI
GitHub: msf899/CamShield-AI
Stars: 2 | Forks: 0
# 🛡️ CamShield AI
**Professional IoT Camera Security Audit Tool**
[](https://python.org)
[](https://fastapi.tiangolo.com)
[](https://react.dev)
[](https://docker.com)
[](LICENSE)
[](https://github.com/yourusername/camshield-ai/stargazers)
*Scan → Detect → Audit → Protect*
## ✨ What is CamShield AI?
CamShield AI is an **ethical cybersecurity tool** for auditing IoT cameras and network devices. It does NOT break anything — it finds vulnerabilities so you can fix them before attackers do.
Think of it as a **doctor checkup for your network cameras**.
┌─────────────────────────────────────────────────────┐
│ YOUR NETWORK │
│ │
│ Router ──┬── 192.168.1.15 Hikvision ⚠ VULNERABLE │
│ ├── 192.168.1.22 Xiaomi ⚠ WEAK RTSP │
│ ├── 192.168.1.30 Samsung TV ✓ OK │
│ └── 192.168.1.44 Unknown ⚠ HIGH RISK │
└─────────────────────────────────────────────────────┘
## 🚀 Features
| Feature | Description |
|---|---|
| 📡 **Wi-Fi Scanner** | Discover all devices on your network with vendor info |
| 📷 **Camera Detector** | Identify IP cameras by port fingerprinting |
| 🔑 **Default Password Check** | Test against 500+ known default credentials |
| 🎥 **Weak RTSP Checker** | Find unauthenticated RTSP streams |
| 🐛 **CVE Scanner** | Match firmware against CVE database |
| 🗺️ **Network Map** | Live visual topology of your network |
| 🤖 **AI Risk Scoring** | AI-powered risk analysis & recommendations |
| 📲 **Telegram Alerts** | Real-time notifications for new threats |
| 🖥️ **SOC Dashboard** | Professional cyberpunk-style web UI |
## ⚡ Quick Start
### Option 1: Docker (Recommended)
git clone https://github.com/msf899/CamShield-AI
cd CamShield-AI
docker compose up
Open `http://localhost:3000` — Dashboard ready! 🎉
### Option 2: Manual Install
**Linux/macOS:**
# Clone
git clone https://github.com/msf899/CamShield-AI
cd CamShield-AI
# Backend
cd backend
pip install -r requirements.txt
python -m app.main
# Frontend (new terminal)
cd frontend
npm install
npm run dev
**Windows:**
# Install nmap from https://nmap.org/download.html first!
# Then same steps as above, or use Docker
## 📸 Screenshots
## 🛠️ Tech Stack
Backend: Python 3.11 · FastAPI · Scapy · Nmap · SQLite/PostgreSQL
Frontend: React 18 · Tailwind CSS · Framer Motion · Recharts
Infra: Docker · WebSocket · Telegram Bot API
## ⚖️ Ethical Use
This tool is for **authorized security auditing only**.
- ✅ Scan your own network
- ✅ Authorized penetration testing
- ❌ Never scan networks without permission
## 📄 License
MIT License — see [LICENSE](LICENSE)
If this helped you, please ⭐ star the repo!