Issue Station
Sign In
Tools hereToolbox

hermes - ✅(Solved) Fix [Bug]: I accidentally interrupted the configuration process of WhatsApp, and as a result, I can no longer proceed with the configuration of WhatsApp. [2 pull requests, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
NousResearch/hermes-agent#13413•Fetched 2026-04-22 08:06:37
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
jenchihjenchih
Participants
jenchihjenchih
Timeline (top)
cross-referenced ×2labeled ×1referenced ×1

Error Message

Error: Cannot find package '/root/.hermes/hermes-agent/scripts/whatsapp-bridge/node_modules/@whiskeysockets/baileys/index.js' imported from /root/.hermes/hermes-agent/scripts/whatsapp-bridge/bridge.js

Additional Logs / Traceback (optional)

Root Cause

Root Cause Analysis (optional)

Fix Action

Fixed

PR fix notes

PR #13448: fix(whatsapp): repair partial bridge installs

Description (problem / solution / changelog)

Summary

  • repair WhatsApp bridge setup when an interrupted npm install leaves a partial node_modules/
  • reuse the package-lock freshness check so stale bridge installs are repaired automatically
  • add regression tests for partial, stale, and healthy bridge dependency states

Testing

  • pytest -o addopts='' tests/hermes_cli/test_whatsapp_setup.py tests/hermes_cli/test_tui_npm_install.py

Closes #13413

Changed files

  • hermes_cli/main.py (modified, +3495/-843)
  • tests/hermes_cli/test_whatsapp_setup.py (added, +93/-0)

PR #13499: fix(whatsapp): recover from interrupted bridge installs (#13413)

Description (problem / solution / changelog)

Summary

  • treat the WhatsApp bridge install as incomplete when required direct dependencies are missing, not just when is absent
  • apply the same dependency-health check in both setup and the runtime adapter
  • add a regression test covering the partial-install path and lock cleanup

Verification

  • independent self-review completed before PR creation

Fixes #13413

Changed files

  • gateway/platforms/whatsapp.py (modified, +9/-2)
  • hermes_cli/main.py (modified, +9/-1)
  • tests/gateway/test_whatsapp_connect.py (modified, +37/-0)

Code Example

hermes debug share
⚠️  This will upload the following to a public paste service:
  • System info (OS, Python version, Hermes version, provider, which API keys
    are configured — NOT the actual keys)
  • Recent log lines (agent.log, errors.log, gateway.log — may contain
    conversation fragments and file paths)
  • Full agent.log and gateway.log (up to 512 KB each — likely contains
    conversation content, tool outputs, and file paths)

Pastes auto-delete after 6 hours.

Collecting debug report...
Uploading...

Debug report uploaded:
  Report  https://paste.rs/xkLmw

⏱  Pastes will auto-delete in 6 hours.
To delete now:  hermes debug delete <url>

Share these links with the Hermes team for support.

---
RAW_BUFFERClick to expand / collapse

Bug Description

hermes whatsapp

⚕ WhatsApp Setup

How will you use WhatsApp with Hermes?

  1. Separate bot number (recommended) People message the bot's number directly — cleanest experience. Requires a second phone number with WhatsApp installed on a device.

  2. Personal number (self-chat) You message yourself to talk to the agent. Quick to set up, but the UX is less intuitive.

Choose [1/2]: 2 ✓ Mode: personal number (self-chat)

✓ WhatsApp enabled

Your phone number (e.g. 15551234567): 189984136 ✓ Allowed users set: 189984136

→ Installing WhatsApp bridge dependencies (this can take a few minutes)...

^C ✗ Install cancelled root@planet-sin01-hixeuy:~# hermes whatsapp

⚕ WhatsApp Setup

✓ Mode: personal number (self-chat)

✓ WhatsApp is already enabled ✓ Allowed users: 189984136

Update allowed users? [y/N] n ✓ Bridge dependencies already installed

────────────────────────────────────────────────── 📱 Open WhatsApp on your phone, then scan:

Settings → Linked Devices → Link a Device ──────────────────────────────────────────────────

node:internal/modules/esm/resolve:205 const resolvedOption = FSLegacyMainResolve(pkgPath, packageConfig.main, baseStringified); ^

Error: Cannot find package '/root/.hermes/hermes-agent/scripts/whatsapp-bridge/node_modules/@whiskeysockets/baileys/index.js' imported from /root/.hermes/hermes-agent/scripts/whatsapp-bridge/bridge.js at legacyMainResolve (node:internal/modules/esm/resolve:205:26) at packageResolve (node:internal/modules/esm/resolve:778:12) at moduleResolve (node:internal/modules/esm/resolve:855:18) at defaultResolve (node:internal/modules/esm/resolve:985:11) at #cachedDefaultResolve (node:internal/modules/esm/loader:731:20) at ModuleLoader.resolve (node:internal/modules/esm/loader:708:38) at ModuleLoader.getModuleJobForImport (node:internal/modules/esm/loader:310:38) at ModuleJob._link (node:internal/modules/esm/module_job:182:49) { code: 'ERR_MODULE_NOT_FOUND' }

Node.js v22.22.2

⚠ Pairing may not have completed. Run 'hermes whatsapp' to try again.

Steps to Reproduce

run hermes whatsapp when is show Installing WhatsApp bridge dependencies (this can take a few minutes)... ctrl +c and Interrupt it

Expected Behavior

Continue with the normal configuration.

Actual Behavior

it cannot work

Affected Component

Gateway (Telegram/Discord/Slack/WhatsApp)

Messaging Platform (if gateway-related)

No response

Debug Report

hermes debug share
⚠️  This will upload the following to a public paste service:
  • System info (OS, Python version, Hermes version, provider, which API keys
    are configured — NOT the actual keys)
  • Recent log lines (agent.log, errors.log, gateway.log — may contain
    conversation fragments and file paths)
  • Full agent.log and gateway.log (up to 512 KB each — likely contains
    conversation content, tool outputs, and file paths)

Pastes auto-delete after 6 hours.

Collecting debug report...
Uploading...

Debug report uploaded:
  Report  https://paste.rs/xkLmw

⏱  Pastes will auto-delete in 6 hours.
To delete now:  hermes debug delete <url>

Share these links with the Hermes team for support.

Operating System

Ubuntu 24.04 LTS

Python Version

Python 3.12.3

Hermes Version

Hermes Agent v0.10.0 (2026.4.16)

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

No response

Proposed Fix (optional)

No response

Are you willing to submit a PR for this?

  • I'd like to fix this myself and submit a PR

extent analysis

TL;DR

The issue is likely due to the interruption of the WhatsApp bridge dependencies installation, causing a module not found error, and can be fixed by reinstalling the dependencies.

Guidance

  • Re-run the hermes whatsapp command to retry the installation of WhatsApp bridge dependencies without interrupting it.
  • If the issue persists, try manually reinstalling the dependencies by deleting the node_modules folder in the /root/.hermes/hermes-agent/scripts/whatsapp-bridge directory and then re-running the hermes whatsapp command.
  • Verify that the @whiskeysockets/baileys package is correctly installed and imported in the bridge.js file.
  • Check the debug report uploaded to the public paste service for any additional error messages or clues.

Example

No code snippet is provided as it's not necessary for this specific issue.

Notes

The issue seems to be related to the interruption of the installation process, and reinstalling the dependencies should fix the issue. However, if the problem persists, further investigation may be required to identify the root cause.

Recommendation

Apply workaround: Reinstall the WhatsApp bridge dependencies by re-running the hermes whatsapp command without interrupting it, and if necessary, manually reinstalling the dependencies. This should fix the module not found error and allow the configuration to continue normally.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#authentication issue#prompt issue#agent setup#task chaining

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - ✅(Solved) Fix [Bug]: I accidentally interrupted the configuration process of WhatsApp, and as a result, I can no longer proceed with the configuration of WhatsApp. [2 pull requests, 1 participants]