a mechub project — sovereign network-security automation
Small, deterministic bots that report to Discord. A bot is a script that prints a finished report, an optional prompt for a local model, and a systemd timer. The model only adds a few lines of advice and has no tools. A how-to with a runner and five example bots, not a product: copy what you need.
Discord is not sovereign. It is a cloud service, used here only as the exit point for scrubbed reports; the full report never leaves your machine. A self-hosted push option (ntfy) is planned.
Needs Linux with systemd, Python 3.11+, PyYAML, Ollama, Hermes Agent and a Discord server you administer.
git clone https://github.com/mechubsec/mecbots ~/mecbots && cd ~/mecbots
mkdir -p ~/.config/systemd/user && cp systemd/labbot@.service systemd/labbot-hellobot.timer ~/.config/systemd/user/ && systemctl --user daemon-reload && systemctl --user enable --now labbot-hellobot.timerThen give hellobot its Discord identity: docs/SETUP.md.
python3 -I bin/run_bot.py hellobot --dry-run # prints the report, posts nothing
uvx --with pyyaml pytest -q tests # the testsTo start your own, copy bots/hellobot: docs/FIRST-BOT.md.
| Bot | What it does | |
|---|---|---|
hellobot |
free disk space and load; the smallest bot | |
socbot |
daily security report from SSDF, with a queue for an agent | |
skillbot |
installed agent skills against upstream releases | |
reposbot |
nightly check that skills still produce config a device accepts | |
canarybot |
boots each new release image; silent unless one appeared |
- docs/SETUP.md · docs/FIRST-BOT.md · docs/RULES.md · docs/IDEAS.md
- docs/CAVEATS.md · docs/VERSIONING.md · CHANGELOG.md · LICENSE
- Agents: a riskier tier that gives the model read-only tools: mecagents.