edgewalker 0.1.6

IoT Home Network Security Scanner

EdgeWalker - Assisting in securing your network

EdgeWalker is a high-performance edge security scanner that audits your home network for open ports, default credentials, and known vulnerabilities. Developed by periphery), it empowers users to verify the security claims of their smart devices rather than relying on marketing labels.

periphery.security

Contributing Guidelines · Submit an Issue

---

EdgeWalker Demo	Scan Report

---

Key Features

Feature	Description	How it Works
Port Scan	Identifies open ports and active services.	nmap wrapper with parallel batch scanning.
Device Discovery	Enhanced fingerprinting for accurate identification.	mDNS/Bonjour, UPnP/SSDP, and HTTP metadata scraping.
Credential Test	Checks for default/weak passwords (SSH, FTP, Telnet, SMB).	Bundled database of ~430 common default credentials.
CVE Check	Matches detected software against known vulnerabilities.	Real-time NVD API lookup.
Risk Scoring	Provides an actionable security grade (A-F).	Proprietary scoring engine (0-100).

---

Installation

One-Line Installer

curl -sSL https://raw.githubusercontent.com/periphery-security/edgewalker/main/scripts/install.sh | sudo bash

Manual Installation (via pipx)

pipx install edgewalker

or

pipx install git++https://github.com/periphery-security/edgewalker.git

The installer verifies Python 3.11+, installs nmap if missing, and configures edgeWalker as a global CLI command.

NOTE: We are currently awaiting approval of the package on pypi.org to allow edgeWalker to be installed via pipx as a package.

---

Quick Start

Interactive Mode (TUI)

edgewalker

Note: On macOS, use sudo edgewalker. On Linux, the installer configures nmap capabilities, removing the need for sudo.

CLI Mode

edgewalker scan                    # Quick port scan (~30s)
edgewalker scan --full             # Full 65,535 port scan
edgewalker scan --target 10.0.0.1  # Scan a single device
edgewalker creds                   # Test default credentials
edgewalker cve                     # Check for known CVEs
edgewalker report                  # View security report

CI/CD & Automation

EdgeWalker supports non-interactive execution for automated environments:

# Run a silent scan with explicit telemetry opt-in
edgewalker --silent --accept-telemetry scan --target 192.168.1.0/24

See the Configuration Guide for more details.

---

The Periphery Mission

We frequently encounter vendors who promise "secure by design" devices. We don't buy it. EdgeWalker began at Periphery's 2025 Hackathon, built in 48 hours by Dr Lina Anaya, Travis Pell, Steven Marks, and Adam Massey. It represents our commitment to transparency and evidence-based security at the edge.

---

Contributing

Contributing Guidelines

Read through our contributing guidelines to learn about our submission process, coding rules, and more.

Want to help?

Want to report a bug, contribute some code, or improve the documentation? Excellent! Read our guidelines for contributing and then check out one of our issues labeled as help wanted or good first issue.

Code of Conduct

Help us keep Edgewalker open and inclusive. Please read and follow our Code of Conduct.

---

Legal Disclaimer

EdgeWalker is for authorized security testing only. Use this tool only on networks and devices you own or have explicit permission to scan. Unauthorized scanning of third-party networks may be illegal. Periphery and the EdgeWalker contributors assume no liability for misuse of this tool.

---

Support the Project

If EdgeWalker helps you secure your home, please give us a Star on GitHub! It helps others find the project and keeps us motivated to build more.

---

License

Distributed under the MIT License. See LICENSE for more information.