mecbots
Homelab bots that report to Discord
A how-to and small framework for homelab bots: deterministic collectors, advice from a local model, scrubbed Discord reports.
About
mecbots is a how-to and small framework for homelab bots. Each bot is a deterministic collector that prints a report; a shared runner adds a few lines of advice from a local model, which is given no tools, and posts to Discord through Hermes Agent.
Reporting has two tiers: the full report stays on local disk, and Discord gets a scrubbed copy with IP addresses, MAC addresses and names from a private redact list removed. Scrubbing fails closed. It is an alpha how-to, not a product: copy what you need.
Discord is not sovereign: it is a cloud service, used only as the exit point for scrubbed reports. A self-hosted push option (ntfy) is planned.
Features
- Five example bots: hellobot (disk and load), socbot (daily SOC brief from SSDF), skillbot (installed agent-skill versions against upstream releases, with a basic prompt-injection screen of new versions), reposbot (nightly commit-check rig) and canarybot (release canary for MCP server images)
- The model only adds advice and has no tools
- Full report kept locally; scrubbed copy posted to Discord
- Runs from systemd user timers; each bot is its own Hermes profile and Discord application
- Alpha: expect rough edges
Quick start
Clone, install the hellobot timer, then follow docs/SETUP.md for its Discord identity
git clone https://github.com/mechubsec/mecbots ~/mecbots && cd ~/mecbots
mkdir -p ~/.config/systemd/user && cp systemd/[email protected] systemd/labbot-hellobot.timer ~/.config/systemd/user/ && systemctl --user daemon-reload && systemctl --user enable --now labbot-hellobot.timer