Back to list

homelab-diagram

The script behind a r/homelab network diagram: a YAML file in, a big SVG/PNG diagram out — line width is link speed.

电量还有一格
Author
@电量还有一格
Project ShowcaseToolsOnlineclaude-code
0
0

Project intro

homelab-diagram is the script behind a network diagram of the author's homelab, the kind people post on r/homelab. It turns a YAML file describing the lab into a big SVG/PNG diagram: the path from the internet through the ISP router and firewall to the core switch, every switch port with its VLANs, and every device with its name, model, IP and OS.

The drawing carries real information in its shapes: a cable's line width is its negotiated link speed — 10G, 2.5G, 1G or 100M — trunks are a white cable with a dark core, and a tall bar on a port means untagged while short bars mean tagged. The Proxmox host shows its hardware, VMs and containers, the TrueNAS pools show disks and usage, and a legend, networks table and media pipeline explainer fill the rest.

It is built to be adapted, not just admired: a CLAUDE.md file tells an AI agent how the code is structured, which parts of the layout are hardcoded, and what to ask about your network, so you can clone it, open it with Claude Code, and have it interview you about your lab and iterate on the render. The author reached the posted diagram in about 60 rounds of feedback. It has 1,443 stars on GitHub with 120 forks, was created on 7 November 2026, and was last pushed on 14 November 2026.

Two honest limits: the author says plainly this is not a general tool — the layout is hand-placed for exactly their network, so expect to move coordinates around in the code for yours. And it needs Python 3.11 with PyYAML and Pillow, rsvg-convert for the PNG, and the Fira Sans and Fira Code fonts installed.

Actions

Visit project URL

Tech stack

pythonpyyamlpillow

Project info

Project category
Tools
Project status
Online
Collaboration intent
None

Comments (0)

ME
0/1000
Loading comments...