whatisgithub

What is netmon?

landonlockhart15-rgb/netmon — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · ops devopsComplexity · 3/5Setup · moderate

In one sentence

A local Windows dashboard that scans your home network, blocks ads via DNS, and uses local AI to explain what it finds.

Mindmap

mindmap
  root((NetMon))
    What it does
      Discover network devices
      Block ads via DNS
      Analyze traffic
    Tech stack
      Python
      FastAPI
      nmap
    Use cases
      Home network monitoring
      Ad and tracker blocking
      Authorized security testing
    Audience
      Home users
      Security hobbyists
    Notes
      Windows only
      Local first
      Optional local AI

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Discover and track every device connected to your home network from a browser dashboard.

USE CASE 2

Block ads and trackers across your whole home network at the DNS level.

USE CASE 3

Run authorized penetration testing tools through WSL and Kali from the Security Lab section.

USE CASE 4

Get plain-English explanations of suspicious network activity from a locally running AI model.

What is it built with?

PythonFastAPInmapOllama

How does it compare?

landonlockhart15-rgb/netmon0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity3/54/51/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Windows 10/11, Python 3.10+, nmap on PATH, and administrator permission for several features.

The README does not state a license.

So what is it?

NetMon is a local-first network security console built for Windows. It runs from a tray icon with a dashboard you open in a browser at localhost, and it is meant to keep all of your data on your own PC rather than sending it anywhere else. The core features cover discovering devices on your home network with nmap, tracking device history and open ports, checking internet and router connection health, and summarizing captured traffic using Wireshark's dumpcap and tshark tools. It includes a DNS based ad blocker that uses several public blocklists, along with anomaly detection, checks against threat intelligence sources, and firewall actions that can be reversed. A Security Lab section wraps authorized testing tools that run through WSL and Kali Linux, such as Nikto, Hydra, John the Ripper, Metasploit, Aircrack-ng and Shodan lookups. NetMon can also use a locally run AI model through Ollama to help explain what it finds, with optional support for cloud AI providers as a fallback, and it can send push notifications with action buttons through a self hosted service called ntfy. To run it you need Windows 10 or 11, Python 3.10 or newer, and nmap available on your system path, with Ollama, Wireshark and ntfy as optional extras depending on which features you want. Setup is done with a PowerShell script that creates a virtual environment, installs dependencies, copies an example environment file, and prompts you to set a dashboard password. The start script asks for administrator permission because several features, including device discovery, firewall actions and DNS binding on port 53, need it. On startup NetMon tries to automatically detect your network adapter, gateway and subnet, or you can set a specific address range manually in the configuration file. The README is explicit about privacy: runtime data such as the database, packet captures, uploaded files and blocklist caches stay local and are excluded from version control, and any API keys or notification passwords should be kept in a private, gitignored configuration file rather than committed to the repository. It also includes a troubleshooting section covering issues like nmap not being found, incorrect scan results, a missing dashboard password, an unconfigured AI provider, port 53 conflicts with the DNS blocker, and ntfy notifications failing to reach a phone on the local network.

Copy-paste prompts

Prompt 1
Run the NetMon setup script and start it with administrator permission on Windows.
Prompt 2
Configure NetMon to use Ollama with the qwen2.5:3b model for local AI investigation.
Prompt 3
Set SCAN_TARGET to a specific subnet range so NetMon scans the correct network.
Prompt 4
Set up ntfy push notifications so NetMon alerts my phone when it detects something.

Frequently asked questions

What is netmon?

A local Windows dashboard that scans your home network, blocks ads via DNS, and uses local AI to explain what it finds.

What language is netmon written in?

Mainly Python. The stack also includes Python, FastAPI, nmap.

What license does netmon use?

The README does not state a license.

How hard is netmon to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is netmon for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.