# NousResearch/hermes-agent · WhatsApp Baileys install errors and repair fixes

## Open now

- 2 issues, 3 PRs open on GitHub.
- #13413: \[Bug\]: I accidentally interrupted the configuration process of WhatsApp, and as a result, I can no longer proceed with the configuration of WhatsApp.
- #52713: WhatsApp pairing fails with ERR_MODULE_NOT_FOUND for @whiskeysockets/baileys on macOS M1 (v0.17.0)
- PR #13448: fix(whatsapp): repair partial bridge installs
- PR #13499: fix(whatsapp): recover from interrupted bridge installs (#13413)
- PR #52721: fix(cli): detect incomplete Baileys install in hermes whatsapp setup

These items cover bugs and fixes related to interrupted or broken WhatsApp bridge installations involving the Baileys dependency, including module-not-found errors, incomplete installs, and CLI detection of corrupted setups.

## TL;DR

- 5 member(s): 2 open issue(s), 0 closed issue(s), 3 open PR(s), 0 merged PR(s), 0 PR(s) closed without merging.
- No fix has been merged to main; one or more PRs were attempted (see below).
- **Recommended:** review the prior/competing PR(s) below. A fix was attempted but not merged; your case may extend or revive that work.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.34`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Open related issues

- #13413: \[Bug\]: I accidentally interrupted the configuration process of WhatsApp, and as a result, I can no longer proceed with the configuration of WhatsApp.
- #52713: WhatsApp pairing fails with ERR_MODULE_NOT_FOUND for @whiskeysockets/baileys on macOS M1 (v0.17.0)

## Prior & competing PRs

- **#13448: fix(whatsapp): repair partial bridge installs**. open
  - maintainer direction: category `partial_fix`; implication `needs_llm`
  - files: `hermes_cli/main.py`, `tests/hermes_cli/test_whatsapp_setup.py`
- **#13499: fix(whatsapp): recover from interrupted bridge installs (#13413)**. open
  - maintainer direction: category `partial_fix`; implication `needs_llm`; refs `5600105478ffde29d7566b45421b100eaa29c4ef`
  - files: `gateway/platforms/whatsapp.py`, `hermes_cli/main.py`, `tests/gateway/test_whatsapp_connect.py`
- **#52721: fix(cli): detect incomplete Baileys install in hermes whatsapp setup**. open
  - maintainer direction: category `partial_fix`; implication `needs_llm`
  - files: `hermes_cli/main.py`, `tests/hermes_cli/test_whatsapp_baileys_module_check.py`

## Fix status

- No merged fix on record.
- Subsystem: `gateway`