hermes - 💡(How to fix) Fix [Setup]: WhatsApp bridge npm install timeout too short (60s) on container startup [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#14980Fetched 2026-04-24 10:43:51
View on GitHub
Comments
0
Participants
1
Timeline
5
Reactions
0
Participants
Timeline (top)
labeled ×4referenced ×1

Error Message

Error:

Full Error Output

Root Cause

Description : When starting the Hermes container on Unraid (and likely other NAS/slower systems), the WhatsApp bridge fails to install dependencies because the npm install timeout is hardcoded to 60 seconds.

Fix Action

Fix / Workaround

Workaround: Manual npm install inside the container after startup: bash docker exec -it hermes-agent sh -c 'cd /opt/hermes/scripts/whatsapp-bridge && npm install --verbose'

Code Example



---

[Whatsapp] Installing WhatsApp bridge dependencies...
[Whatsapp] Failed to install dependencies: Command '['npm', 'install', '--silent']' timed out after 60 seconds
[Whatsapp] Disconnecting (external bridge left running)
[Whatsapp] Disconnected
[Whatsapp] Bridge process died (exit code 1)
RAW_BUFFERClick to expand / collapse

What's Going Wrong?

Description : When starting the Hermes container on Unraid (and likely other NAS/slower systems), the WhatsApp bridge fails to install dependencies because the npm install timeout is hardcoded to 60 seconds.

Environment :

  • Platform: Unraid (Docker container)
  • Hermes version: latest

Error:

[Whatsapp] Installing WhatsApp bridge dependencies... [Whatsapp] Failed to install dependencies: Command '['npm', 'install', '--silent']' timed out after 60 seconds [Whatsapp] Disconnecting (external bridge left running)

Location: /opt/hermes/gateway/platforms/whatsapp.py line 387

Suggested fix: Increase timeout from 60s to 300s (5 minutes), or make it configurable via environment variable.

Workaround: Manual npm install inside the container after startup: bash docker exec -it hermes-agent sh -c 'cd /opt/hermes/scripts/whatsapp-bridge && npm install --verbose'

Steps Taken

  1. Updated Hermes Docker container on Unraid to latest version
  2. Container started, WhatsApp bridge attempted to auto-install dependencies
  3. npm install timed out after 60 seconds and bridge failed to start

Installation Method

Docker

Operating System

Unraid (Docker container)

Python Version

No response

Hermes Version

No response

Debug Report

Full Error Output

[Whatsapp] Installing WhatsApp bridge dependencies...
[Whatsapp] Failed to install dependencies: Command '['npm', 'install', '--silent']' timed out after 60 seconds
[Whatsapp] Disconnecting (external bridge left running)
[Whatsapp] Disconnected
[Whatsapp] Bridge process died (exit code 1)

What I've Already Tried

No response

extent analysis

TL;DR

Increase the npm install timeout to a higher value, such as 300 seconds, or make it configurable via an environment variable to prevent timeouts on slower systems.

Guidance

  • Identify the line of code responsible for setting the npm install timeout (line 387 in whatsapp.py) and consider increasing the value to 300 seconds as suggested.
  • Alternatively, explore making the timeout configurable via an environment variable for more flexibility.
  • Verify the effectiveness of the change by attempting to start the Hermes container and checking if the WhatsApp bridge dependencies install successfully.
  • If manual intervention is preferred, use the provided workaround: docker exec -it hermes-agent sh -c 'cd /opt/hermes/scripts/whatsapp-bridge && npm install --verbose' to install dependencies after container startup.

Example

No code snippet is provided as the issue does not require a new code example, but rather a modification to an existing setting or the use of a provided workaround command.

Notes

The suggested fix assumes that increasing the timeout will resolve the issue, but other network or system factors could still cause timeouts. Making the timeout configurable can help mitigate such issues in the future.

Recommendation

Apply the workaround by manually installing dependencies using the provided docker exec command until a more permanent solution, such as increasing or configuring the timeout, can be implemented. This approach ensures the WhatsApp bridge can function while a more robust fix is considered.

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…

Still need to ship something?

×6

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

Back to top recommendations

TRENDING