Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

IoT Risk Detect: FOSS IoT Security & Botnet Detection Desktop App

Screenshot 2025-07-20 191034

🚀 Project Vision

IoT Risk Detect is a free and open-source (FOSS) desktop tool for real-time discovery, risk assessment, and botnet/anomaly detection of IoT devices on your local network. It empowers users, researchers, and defenders to:

  • Discover all IoT devices on their network
  • Assess risk (open ports, vendor, suspicious MACs)
  • Detect botnet-like behavior (heuristics + ML anomaly detection)
  • Export and analyze results for further action

No cloud, no vendor lock-in, no data collection. 100% local, 100% FOSS.


✨ Features

  • Network scan: ARP-based device discovery
  • Risk assessment: Open ports, vendor, MAC analysis
  • Botnet detection:
    • Heuristic (bad IPs, port/protocol, external IPs)
    • ML-based (Isolation Forest anomaly detection)
  • Detailed device view: Double-click for all info & risk reasons
  • Export: Save results (CSV) for compliance or research
  • Modern GUI: PyQt5, color-coded, status bar, responsive
  • No database, no server, no web UI

🛠️ Installation

Native (Recommended)

  1. Clone the repo:
    git clone https://github.com/flatmarstheory/iot-risk-detect.git
    cd iot-risk-detect
  2. Install dependencies:
    pip install -r requirements.txt
  3. Run the app:
    python main.py

    Run as administrator/root for full network scan capability.

Docker

  1. Build the image:
    docker build -t iot-risk-detect .
  2. Run the app:
    docker run --rm -it --net=host --env DISPLAY=$DISPLAY \
      -v /tmp/.X11-unix:/tmp/.X11-unix iot-risk-detect

    You must allow X11 forwarding for GUI apps in Docker. See docs for Windows/Mac.


🤝 Contributing


📜 License

MIT License. See LICENSE.


💡 FOSS & IoT Security Focus

  • 100% open source, no telemetry, no vendor lock-in
  • Designed for researchers, defenders, and privacy advocates
  • Use at your own risk. For educational and defensive purposes only.

🌐 Links

About

A desktop tool for real-time discovery, risk assessment, and botnet/anomaly detection of IoT devices on your local network.

Resources

Stars

11 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages