Lotus Guild

Tooling I built to run my own homelab: a six-node Proxmox/Ceph cluster on a UniFi network, with SSO, monitoring, ticketing and a self-hosted Matrix stack. Most of it is specific to my setup, so each repo leads with screenshots, demo GIFs and a one-line "Quick run" command to show what it does.

Wiki: wiki.lotusguild.org has architecture write-ups, including the infrastructure overview.

Projects

	Project	What it does
	gandalf	Network diagnostics dashboard. Correlates UniFi switch ports, Linux link state and LLDP to find faults. Python / Flask.
	pulse	Command and workflow orchestrator for the whole fleet, with approvals and live execution logs. Node.js / WebSocket.
	tinker_tickets	Ticketing system with workflows, audit log, API keys and an MCP interface. PHP / MariaDB.
	hwmonDaemon	Hardware health daemon: SMART, memory, CPU and network checks that open tickets automatically. Python.
	analyzeOSDs	Ranks Ceph OSDs for replacement using SMART, utilisation and performance data.
	proxDoc	Health check for Proxmox hosts. Bash.
	driveAtlas	Draws ASCII maps of server drive bays with SMART and Ceph details. Bash.
	web_template	Terminal-style UI template shared by the apps above.

Infrastructure

matrix: Synapse, LiveKit, Hookshot and Draupnir configuration for the self-hosted chat server.
cinny, cinny-desktop and element-call: forks used for the Lotus Chat client, desktop app and calls.
freshStartScript: first-run setup for new Proxmox nodes.
discordBot: archived. Replaced by Matrix.

About

Everything is deployed with GitOps-style signed webhooks, and monitored through the same tools shown above. Repos are MIT licensed unless they are forks, which keep their upstream licenses.

gandalf

CSS 1 0 0

GANDALF: Global Advanced Network Detection And Link Facilitator. Flask dashboard that correlates UniFi switch ports with Linux link state and LLDP to diagnose network faults.

flask homelab lldp network-monitoring python unifi

Updated 2026-11-04 23:47:40 -05:00

matrix

Python 0 0 0

Matrix homeserver infrastructure for matrix.lotusguild.org — Synapse, LiveKit, Hookshot, Draupnir, and Cinny configuration

homelab livekit matrix self-hosted synapse

Updated 2026-11-04 22:42:07 -05:00

cinny-desktop

Rust 0 0 0

Lotus Chat desktop app (Tauri wrapper for cinny)

desktop-app fork matrix tauri

Updated 2026-11-04 21:51:18 -05:00

cinny

TypeScript 0 5 0

Lotus Guild fork of Cinny — custom Matrix web client

cinny fork matrix self-hosted

Updated 2026-11-04 21:47:32 -05:00

devdesk

JavaScript 0 0 0

Persistent browser terminal for Claude Code (ttyd + tmux, LotusGuild TDS) at dev.lotusguild.org, packaged as a .deb

Updated 2026-11-03 21:23:44 -05:00

element-call

TypeScript 0 0 0

Lotus fork of element-hq/element-call — self-built embedded bundle for Lotus Chat. AGPL-3.0.

element-call fork matrix webrtc

Updated 2026-10-30 21:16:16 -04:00

freshStartScript

Shell 0 0 0

A bash script for automating Proxmox installations with Prometheus Node Exporter and system health monitoring tools.

automation bash homelab node-exporter proxmox

Updated 2026-10-06 23:38:28 -04:00

.profile

0 0 0

Organization profile README

Updated 2026-10-04 13:06:10 -04:00

driveAtlas

Shell 0 0 0

A Bash-based server drive mapping utility that generates ASCII visualizations of server layouts and provides comprehensive drive information for data center operations.

bash drive-mapping homelab storage sysadmin

Updated 2026-10-04 13:05:44 -04:00

proxDoc

Shell 0 0 0

A comprehensive diagnostic tool for Proxmox servers that performs system health checks and monitoring - your virtual system's doctor! 🏥

bash diagnostics health-check homelab proxmox

Updated 2026-10-04 13:05:44 -04:00

pulse

JavaScript 1 0 0

PULSE: Pipelined Unified Logic & Server Engine. Central orchestrator that runs commands and workflows across a fleet of nodes via workers, with a live web UI.

automation homelab nodejs orchestration websocket

Updated 2026-10-04 13:05:44 -04:00

analyzeOSDs