NetPulse

The VPS inspector built for AI agents: one command from your laptop, health-check your whole fleet, pipe results straight to an agent.

English · 中文

🌐 Website: https://genuifx.github.io/NetPulse/

Why NetPulse: agent-friendly + fleet inspection

Other checkup scripts make you SSH into each box and run them. NetPulse flips it — you launch from your laptop, it executes on the remote box, results come back to you:

• Launch locally: --host user@host ships the script over SSH and runs it remotely; missing deps auto-install, zero manual steps on the remote
• Fleet inspection: repeat --host to check your whole fleet at once, with a multi-host comparison table
• JSON output: --json is machine-readable — pipe into jq or feed to an AI agent
• Non-interactive: no prompts, no color in JSON mode, clear errors + non-zero exit codes so agents never hang

# Inspect three boxes, hand the JSON to an agent
python3 netpulse.py --host root@vps-a --host root@vps-b --host root@vps-c --json | jq .

One-liner

bash <(curl -sL https://raw.githubusercontent.com/Genuifx/NetPulse/main/install.sh)

Or manually:

git clone https://github.com/Genuifx/NetPulse.git && cd NetPulse
python3 netpulse.py

Only dependency is requests (auto-installed when missing).

What it checks

Category	Details
IP info	Egress IP, location, ASN, ISP
IP purity	Datacenter IP / residential IP / proxy traits
DNS leak	Resolver geo vs IP geo
Unlock tests	Netflix, Disney+, YouTube Premium, HBO Max, Hulu, Prime Video, TikTok, Spotify, ChatGPT, Claude, Gemini (11 targets)
Network quality	IPv6 egress, TCP latency to Cloudflare/Google/Baidu, download speed

--share saves a Markdown report — handy for group chats or support tickets.

The standard agent recipe

# Quick verdict: IP purity + unlock count
python3 netpulse.py --host root@1.2.3.4 --json \
  | jq '{purity: .purity, unlock: [.unlock[] | select(. == 200)] | length}'

# Inspect the whole fleet
python3 netpulse.py --host root@a --host root@b --host root@c --json \
  | jq '.[] | {host, purity, ipv6}'

JSON fields: tool / version / timestamp / host / ip / purity / dns / unlock / ipv6 / latency / speed / summary; on failure an error field + non-zero exit code.

FAQ

How accurate are the unlock tests? HTTP status only — a first pass (200 ≈ reachable, 403/451 ≈ likely geo-blocked). Use a dedicated script to double-check Netflix etc. We're the quick triage, not the final word.

What does --host need? An ssh binary locally, python3 on the remote, and key-based auth (BatchMode=yes — no interactive password prompts).

Jump hosts / custom ports? --host is plain SSH — your ~/.ssh/config applies as usual.

Disclaimer

This tool inspects the network of your own servers only. It does not scan or track anyone else. Don't run it on machines you aren't authorized for.