I built this out of frustration with flaky Wi-Fi and poor network throughput on Linux.
network-debug is a Python-based CLI tool that diagnoses, benchmarks, and tunes your system to get closer to your full network potential — especially over Wi-Fi.
What it does:
Diagnoses TCP, Wi-Fi, DNS, VPN, driver, and routing issues
Suggests smart, safe config fixes (or applies them)
Supports interactive mode and full dry-run
Benchmarks before/after using ping, iperf3, and retransmits
Works on Ubuntu, Arch, Fedora, Alpine — systemd-aware
Backs up configs before changing anything, with rollback safety
No curl-pipe-to-bash, no daemons, no fluff
The goal was: clean, safe, minimal, useful.
I’d love feedback from folks who run Linux as a daily driver or manage systems — good, bad, brutal — especially around real-world compatibility or tuning recommendations.
What it does:
The goal was: clean, safe, minimal, useful. I’d love feedback from folks who run Linux as a daily driver or manage systems — good, bad, brutal — especially around real-world compatibility or tuning recommendations.