Scanopy: Clean Network Diagrams, Zero Upkeep

If you've ever spent an afternoon wrestling with a drag-and-drop diagram tool just to map out a simple network, you know the pain. The boxes never quite align, adding a new server means rearranging everything, and keeping it updated is a chore you'll probably avoid. What if your infrastructure could just document itself?

That's the idea behind Scanopy. It's a tool that automatically generates clean, readable network diagrams from a live scan of your environment. You set it up once, and it handles the rest.

What It Does

Scanopy is a Python-based tool that discovers devices on your network, figures out how they're connected, and then draws a diagram for you. You run it, point it at a network range, and it outputs a visual map—typically as an SVG or PNG file. No manual drawing required.

It works by combining active scanning to find live hosts with analysis to infer connections and roles, then passing that structured data to a diagramming library to render a sensible layout automatically.

Why It's Cool

The real magic isn't just in the automation; it's in the maintenance-free promise. Network diagrams are notorious for becoming outdated the moment you save the file. Scanopy turns a static snapshot into a dynamic report you can regenerate on-demand. Need an updated view after a deployment? Just run the scan again.

It's also built with a developer's mindset. The output is clean and minimal, avoiding the visual clutter of enterprise tools. It gives you the topology without the fluff. Since it's scriptable, you can easily integrate it into a CI/CD pipeline to generate diagrams as part of your deployment process or embed them in documentation that's always current.

How to Try It

Getting started is straightforward. The project is on GitHub, so you can clone it and run it locally. You'll need Python and pip installed.

git clone https://github.com/scanopy/scanopy.git
cd scanopy
pip install -r requirements.txt
# Run a basic scan (adjust the network range for your environment)
python scanopy.py 192.168.1.0/24 -o network-diagram.svg

Be sure to run it on a network you have permission to scan. Check the repository's README for more advanced options, like specifying ports or using different output formats.

Final Thoughts

Scanopy solves a specific, annoying problem in a beautifully direct way. It won't replace full-featured monitoring suites, but for developers, sysadmins, or DevOps folks who need a quick, accurate visual of their network layout, it's a brilliant utility. It turns a task that's normally manual and neglected into something automated and useful. The next time you're onboarding someone new or documenting a setup, let the network draw its own map.

Follow us for more cool projects: @githubprojects