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.