Goblinmine/homelab-diagram

Renders an r/homelab-style network diagram from a YAML inventory (Python → SVG/PNG). Written with Claude.

Open original source ↗

From the publisher

README & documentation

Source preview

Read the project’s overview, installation instructions and usage examples. The original README is the source of truth.

The script behind the network diagram of my homelab that I posted on r/homelab. It turns a YAML file describing the lab into a big SVG/PNG diagram in the style of the diagrams you see on r/homelab. On Arch/CachyOS: pacman -S python-yaml python-pillow librsvg ttf-fira-sans ttf-fira-code On Debian/Ubuntu: apt install python3-yaml python3-pil librsvg2-bin fonts-firacode plus Fira Sans The service icons are not in this repo, fetchicons.py downloads them from homarr-labs/dashboard-icons. Only my own small glyphs (icons/glyph-.svg: CPU, RAM, SSD, …) are included. The repo contains a CLAUDE.md with everything an AI agent needs to adapt it to your lab: how the code is structured, which parts of the layout are hardcoded, the questions to ask about your network, the render-and-check loop, and the design rules this diagram follows. Clone the repo, open it with Claude Code and say something like "help me make this diagram for my homelab". It will…

Goblinmine/homelab-diagram on GitHub A short preview, not the full document.

Read the full README ↗ · Preview checked 2026-11-11T13:15:18.326Z

Inside the original README — Document outline
  1. homelab-diagram
  2. What it shows
  3. How it works
  4. Requirements
  5. Usage
  6. Making it your own
  7. Using it with Claude Code
  8. How it was made
  9. Example prompts
  10. Credits & license

Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.

Links from the README

References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.

Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.

What this repository does

Renders an r/homelab-style network diagram from a YAML inventory (Python → SVG/PNG). Written with Claude.

Repository facts

Owner
Goblinmine
Primary language
Python
Stars
1,006
Forks
85
Open issues + pull requests
2
License
MIT
Archived
No
Default branch
main
Created
2026-11-07T12:45:46.000Z
Last push
2026-11-07T12:51:26.000Z

Topics and intended use

No topics were included in the latest source metadata.

Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.

Evaluate before installing

Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.

README and project files

Issues and maintenance discussion

Releases and changelog

Source and freshness

Source: GitHub. Metadata observed 2026-11-14T12:24:55.365Z. Daily imports are snapshots, not real-time monitoring.

Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.

Open original source

Related repositories

public-apis/public-apis

EbookFoundation/free-programming-books

donnemartin/system-design-primer

vinta/awesome-python

practical-tutorials/project-based-learning

NousResearch/hermes-agent