hermes - ✅(Solved) Fix Bug: browser_vision screenshot fails on WSL2 with Browserbase remote backend [1 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#11729Fetched 2026-04-18 05:59:10
View on GitHub
Comments
0
Participants
1
Timeline
1
Reactions
0
Author
Participants
Timeline (top)
cross-referenced ×1

Error Message

When using browser_vision tool on a WSL2 Linux environment, screenshots fail with the error: Failed to save screenshot to /home/<user>/.hermes/cache/screenshots/<id>.png: 系统找不到指定的路径。 (os error 3)

Root Cause

Browserbase runs as a remote browser service. The screenshot path /home/<user>/.hermes/cache/screenshots/ is a WSL local path that Browserbase remote servers cannot access. Even when the directory exists locally, the remote browser process cannot write to it.

Fix Action

Fix / Workaround

Add a config option like browser.screenshot_dir to redirect screenshot output to a path accessible by Browserbase, or implement a workaround where screenshots are saved via a local agent-side mechanism rather than by the remote browser process.

PR fix notes

PR #11752: fix(browser): persist remote browser_vision screenshots locally

Description (problem / solution / changelog)

Summary

  • stop passing Hermes-local screenshot output paths to remote cloud browser sessions
  • copy the temp screenshot returned by agent-browser back into Hermes' managed cache before vision analysis
  • add regression coverage for both cloud screenshot capture and unchanged local-mode behavior

Root Cause

browser_vision() always passed a local ~/.hermes/cache/screenshots/... path into the screenshot command and then immediately expected that same host path to exist. That works for local Chromium, but remote Browserbase/CDP sessions cannot write into WSL or other host-local filesystem paths.

Testing

  • python3 -m py_compile /Users/stephenyu/Documents/hermes-agent-wt-11729/tools/browser_tool.py /Users/stephenyu/Documents/hermes-agent-wt-11729/tests/tools/test_browser_console.py
  • uv run --directory /Users/stephenyu/Documents/hermes-agent-wt-11729 --extra dev pytest -o addopts='' /Users/stephenyu/Documents/hermes-agent-wt-11729/tests/tools/test_browser_console.py -q

Platform Tested

  • macOS

Contribution Guide Notes

  • keeps the fix scoped to browser_vision() and its regression tests
  • resolves #11729

Changed files

  • tests/tools/test_browser_console.py (modified, +99/-0)
  • tools/browser_tool.py (modified, +26/-7)

Code Example

Failed to save screenshot to /home/<user>/.hermes/cache/screenshots/<id>.png: 系统找不到指定的路径。 (os error 3)
RAW_BUFFERClick to expand / collapse

Bug Description

When using browser_vision tool on a WSL2 Linux environment, screenshots fail with the error:

Failed to save screenshot to /home/<user>/.hermes/cache/screenshots/<id>.png: 系统找不到指定的路径。 (os error 3)

Root Cause

Browserbase runs as a remote browser service. The screenshot path /home/<user>/.hermes/cache/screenshots/ is a WSL local path that Browserbase remote servers cannot access. Even when the directory exists locally, the remote browser process cannot write to it.

Expected Behavior

browser_vision should work on WSL2 environments using Browserbase remote browser.

Environment

  • OS: WSL2 Ubuntu 24.04
  • Hermes version: v0.10.0 (v2026.4.16)
  • Browser tool: Browserbase remote backend
  • Browser tool status: Connected and functional (navigation, clicking, scrolling all work)

Suggested Fix

Add a config option like browser.screenshot_dir to redirect screenshot output to a path accessible by Browserbase, or implement a workaround where screenshots are saved via a local agent-side mechanism rather than by the remote browser process.

Additional Context

  • All other browser tools work fine (navigate, click, type, scroll, console)
  • The issue only affects browser_vision which needs to save a screenshot file
  • The remote Browserbase service has no access to the WSL filesystem path

extent analysis

TL;DR

Configure browser_vision to save screenshots to a path accessible by Browserbase or implement a local agent-side mechanism for saving screenshots.

Guidance

  • Identify a network-accessible directory where Browserbase can write files, and configure browser_vision to use this directory for screenshot output.
  • Consider implementing a local agent that can receive screenshot data from the remote browser process and save it to a local file, bypassing the need for Browserbase to access the WSL filesystem directly.
  • Verify that the configured directory is accessible and writable by Browserbase to ensure successful screenshot saving.
  • Review the Browserbase documentation for any existing configuration options or APIs that can facilitate screenshot saving in a WSL2 environment.

Example

No code example is provided due to the lack of specific implementation details in the issue.

Notes

The solution may require modifications to the browser_vision tool or the Browserbase remote browser service, and may involve additional configuration or setup steps not specified in the issue.

Recommendation

Apply a workaround by configuring browser_vision to save screenshots to a network-accessible directory or implementing a local agent-side mechanism, as upgrading to a fixed version is not mentioned in the issue. This approach allows for a potential fix without relying on an unspecified future version.

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

hermes - ✅(Solved) Fix Bug: browser_vision screenshot fails on WSL2 with Browserbase remote backend [1 pull requests, 1 participants]