Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Linux
Renders an r/homelab-style network diagram from a YAML inventory (Python → SVG/PNG). Written with Claude.
GitHub didn't answer, so this is the saved copy from 1 days ago
Will it work on Linux?
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
git clone https://github.com/Goblinmine/homelab-diagram.git cd homelab-diagram
Python >=3.11
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync
With uv (creates .venv and installs the pinned dependencies from uv.lock):
uv sync # once: create .venv, install PyYAML + Pillow
uv run fetch_icons.py # downloads the service icons into icons/ (once)
uv run build.py # → out/homelab.svg + out/homelab.png (redacted)
uv run build.py --unredacted # → out/homelab-unredacted.svg + .png
Or with a plain Python install of PyYAML:
python3 fetch_icons.py # downloads the service icons into icons/ (once)
python3 build.py # → out/homelab.svg + out/homelab.png (redacted)
python3 build.py --unredacted # → out/homelab-unredacted.svg + .png
The service icons are not in this repo, fetch_icons.py downloads them from homarr-labs/dashboard-icons. Only my own small glyphs (icons/glyph-*.svg: CPU, RAM, SSD, …) are included.
No reports for Linux yet.
GitManual AI Agent reads the 2 key files and writes a step-by-step guide for Linux. Once written, it's saved for everyone.