Create

Sign in to ReadmeX

or

How we handle your data: Privacy Policy

ReadmeX

Your AI reading companion

What would you like to catch up on?

Pick a briefing, or ask your own question.

Your community and people briefings stay personal to you.

netpulse

netpulse: A self-hosted PWA dashboard that shows the live pulse of your home network, running from a single static Go binary with nothing leaving your LAN.

What problem it solves

Home networks built on OpenWrt/GL.iNet routers are spread across many devices, and there is no single place to see fleet status, per-router health, connected devices, WireGuard peers, AdGuard Home statistics or alerts as they happen. Operators also need topology and health scoring without handing their network state to a third-party cloud service. NetPulse addresses this by collecting all of it locally and pushing it to the browser over SSE.

Key features

  • Fleet overview with a live health score — A single 0-100 score condenses latency, loss, uptime and temperature per router and for the network as a whole, refreshed every 5 seconds over SSE. Live WAN traffic against the contracted plan, an alert feed, AdGuard Home stats and WireGuard peers share the same screen.

    Source: README

  • Self-inferring topology map — Topology is inferred live from the bridge FDB and LLDP where available, placing wired and wireless clients under the router and port they talk through, with managed and inferred switches, Proxmox hosts and WireGuard tunnels drawn from peer to Internet. Nodes can be dragged and the layout stays as placed.

    Source: README

  • Device inventory with classification — Every client is listed with hostnames, IPs, type detection from hostname patterns and OUI, first seen, Wi-Fi band and signal, plus the router it is attached to. Static hosts that never take a DHCP lease are still named through a forward-confirmed reverse lookup for private addresses.

    Source: README

  • Per-router health and on-demand WAN speed tests — Each router card shows model, firmware, CPU, memory, temperature, uptime and live traffic, with port-level history and per-band client splits; units can be paused without losing history. WAN speed tests run on demand or on a schedule and can alert when download speed drops below a chosen percentage of the contracted plan.

    Source: README

Quick start

Copied verbatim from the project's README.

curl -fsSL --retry 3 -o /tmp/netpulse-install.sh https://raw.githubusercontent.com/gnacho/netpulse/main/install.sh && sh /tmp/netpulse-install.sh
echo "<public key from Settings>" >> /etc/dropbear/authorized_keys

Who it may suit

Inference: may suit self-hosters and homelab operators running OpenWrt or GL.iNet routers who want fleet visibility without a cloud dependency. Inference: may also suit mixed environments with MikroTik, Asuswrt/Merlin, OPNsense or UniFi hardware, plus users who want their network state queryable by an AI assistant over a local MCP endpoint.

Topics to discuss

  • How should the health score weight latency, packet loss, uptime and temperature so that it stays meaningful across very different router fleets?

  • What extra integrations should be added next, and should vendor pushers keep living in separate repositories with a shared ingest contract?

  • Which alert channels and thresholds fit real home networks best, and how should the feed level (none / urgent / all) be configured per household?


Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.

Read the original README https://github.com/gnacho/netpulse#readme

ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.

github.comhttps://github.com/gnacho/netpulse

Comments

…