Windows security posture · open source

Find out how exposed
your Windows fleet
actually is.

EndpointRadar audits antivirus, firewall, patching, open ports, running services and installed software — then scores the risk, explains it in plain English, and maps every finding to NIST CSF 2.0. No agent to deploy. No server to run. No licence to buy.

MIT licensed Zero agents Python 3.10+ CLI · GUI · Web API NIST CSF 2.0
PowerShell — endpointradar

The problem

Commercial EDR tells you when you're attacked.
Nothing tells you how easy you'd be to attack.

Most small teams, labs and classrooms have no visibility into basic endpoint hygiene. Is Defender actually on? Is the firewall off on the public profile? Is SMB listening? When was this box last patched? EndpointRadar answers those questions in one command and gives you a number you can track over time.

Antivirus

Detects installed AV products through WMI SecurityCenter2, plus real-time protection state — not just "is Defender installed".

Firewall

Checks Domain, Private and Public profiles independently, because one profile being off is the whole gap.

Patching

Reads the hotfix history, works out days since the last update, and flags suspiciously thin patch counts.

Exposure

Enumerates listening ports and running services, and singles out the ones that widen the attack surface — 445, 3389, RPC.

Scope, honestly stated. EndpointRadar is a posture and exposure scanner, not an EDR. It does not hook processes, watch behaviour in real time, or block anything. It tells you where a machine is weak so you can fix it before something arrives.

Four ways to look

One engine, four vantage points

Every mode produces the same record shape and runs through the same scoring code, so a local scan, a remote scan and a network sweep are directly comparable.

The deep, authenticated view

Runs every check against the machine you're sitting at. This is the richest view: AV state, firewall profiles, hotfix history, listening ports, running services and the full installed-software inventory from the registry.

  • NeedsNothing but Python. Run as admin for full service and port visibility.
  • ProducesA complete scan record plus a risk score from 0 upward.
  • Good forAuditing your own box, CI gates, teaching, baselining.
endpointradar scan
endpointradar scan -f json -o box.json
endpointradar scan -f text          # long report
endpointradar scan --fail-on high   # exit 2 in CI

Real output

What a scan actually gives you

This is rendered live in your browser from examples/sample-scan.json — the same anonymised record shipped in the repository and used by the test suite. Nothing here is mocked up.

—

—
—
Risk score

Risk drivers

Findings

Command reference

The whole CLI

Nine subcommands. Every one takes -f json for machine-readable output and -o FILE to write it somewhere. -q and --no-color work on either side of the subcommand.

CommandWhat it doesKey options
scanFull posture scan of this machine--fail-on --no-save -f summary|json|text
discoverFind live devices on a subnet, no credentials--workers --timeout --include-offline
sweepUnauthenticated port and exposure scan--no-save -f table|json
remoteAgentless scan of a remote host over WinRM-u --password-env --timeout
threatsNIST CSF 2.0 threat analysis of a scan--max -v -d DEVICE
reportWord report — fleet summary or per-device threatsfleet|threat -o out.docx
showRe-read a saved scan without rescanning--all -v --fail-on
dashboardLaunch the Tkinter desktop dashboardneeds the gui extra
serveRead-only web dashboard and JSON API--host --port

Use it as a CI gate

--fail-on makes the process exit with code 2 once the risk level reaches your threshold, so a Windows runner can fail the build when a machine drifts out of policy.

- name: Endpoint posture gate
  run: |
    pip install endpointradar
    endpointradar scan --fail-on high --no-color
  shell: pwsh

Under the hood

How a finding becomes a number

Scoring is deliberately transparent and deterministic. There is no model, no cloud call, and no hidden weighting — you can read the whole thing in risk.py and threats.py.

01

Collect

Native Windows tooling only — WMI, PowerShell, netsh, the registry, psutil. Every collector degrades gracefully when a source is unavailable.

02

Normalise

Everything lands in one JSON record shape, whether it came from this machine, a remote host or a credential-free port scan.

03

Score

Six components — antivirus, firewall, patching, ports, services, third-party software — each capped at 100, then weighted into contributions.

04

Explain

Findings become threats with likelihood × impact (1–5 each), a NIST CSF 2.0 function, and a fix written for a human.

Limited visibility is labelled, not guessed. When a device is scanned without credentials, the record is tagged and the scorer only counts what port evidence supports. An unauthenticated result will never claim a machine has no antivirus — it will say it couldn't tell.

Getting started

Installed and scanning in under a minute

The core install is one dependency. Everything heavier — WinRM, Word reports, the GUI, the web server — is an optional extra you add only if you want it.

Install

git clone https://github.com/4ryanwalia/EndpointRadar
cd EndpointRadar
py -m venv .venv
.venv\Scripts\activate
pip install -e .

endpointradar scan

Optional extras

pip install -e ".[remote]"   # WinRM scanning
pip install -e ".[report]"   # Word + Excel
pip install -e ".[gui]"      # desktop dashboard
pip install -e ".[web]"      # web API
pip install -e ".[all]"      # everything
Use it only where you're allowed to. Discovery and sweep send traffic to every address in the range you give them. Scan networks you own or have written permission to test.
Read the full README Report an issue