mechub sovereign network-security automation ← all projects
bot and agent v0.0.3 · alpha MIT

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

Full instructions in the README ↗