WhatsApp group summary bot for Hermes Agent; records all group messages to JSONL and delivers 2x daily summaries in casual Indonesian. The repo has 11 stars and 0 open issues, published in 2026.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
WhatsApp Group Summary Bot is a bot designed for the Hermes Agent that records all messages in a WhatsApp group and generates structured summaries twice daily (07:00 and 23:00 WIB) in casual Indonesian. It operates with silent recording, activating on mentions or slash commands, and provides optional Roast mode.
How it works
The system records group messages to per-group JSONL logs, then cron jobs generate summaries from the collected logs. It patches several components: the bridge allows messages from all group members, the WhatsApp adapter disables group whitelist filtering, and an explicit log routine writes group messages to JSONL (ts, sender, body). Cron jobs deliver summaries to a specified group at 07:00 and 23:00 WIB. Environment variable WHATSAPP_REQUIRE_MENTION=true is used to gate bot responses in groups.
Getting started
Prerequisites include Hermes Agent installed with WhatsApp gateway, server access, git/curl/python3, and the bot invited to target groups. Installation methods are:
-
⚡ npx (recommended)
npx whatsapp-group-summary -
🎯 Via Hermes CLI
hermes skills install whatsapp-group-summary -
📦 Manual git clone
git clone https://github.com/mocasus/whatsapp-group-summary.git ~/.hermes/skills/whatsapp-group-summary-bot
Patch steps (Patch A/B/C) modify bridge.js, whatsapp_common.py, and adapter.py to enable silent/group recording. Then restart the gateway with: hermes gateway restart
Step 5 verification includes inspecting log files under ~/.hermes/platforms/whatsapp/group_logs/ and viewing a sample entry like: {"ts": 1783736100, "sender": "Nama Kamu", "body": "test"}.
Recent releases
There are no releases listed; latest release block shows none.
Traction
Stars: 11
Behind the repo
This section would include startup/company linkage if present; none provided in the README.
Caveats
License is listed as MIT in the README badge, but the repository metadata shows license: none listed. The installation notes include patches that are overwritten by Hermes updates, requiring re-application after updates. The setup requires Hermes Agent and WhatsApp gateway; changing patches may affect behavior. Logs are stored per group in JSONL format under the user’s home directory.
