Skip to content
mechubsecPublic

About

How to build small homelab bots: deterministic collectors, local-model advice, Discord reports

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

43 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mechub mark

mecbots

a mechub project — sovereign network-security automation

mecbots mascot

license

What this is

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.

Install

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.timer

Then give hellobot its Discord identity: docs/SETUP.md.

Use

python3 -I bin/run_bot.py hellobot --dry-run     # prints the report, posts nothing
uvx --with pyyaml pytest -q tests                # the tests

To 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

More

About

How to build small homelab bots: deterministic collectors, local-model advice, Discord reports

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages