tinyhumansai/openhuman · error

browser.backend='auto' needs Playwright, agent-browser tool,

Error message

browser.backend='auto' needs Playwright, agent-browser tool, or computer-use sidecar

What it means

Terminal error of browser.backend='auto' resolution in a build without browser-native and with no computer-use error to report: no backend (Playwright, agent-browser, computer-use sidecar) is present in the environment.

Source

Thrown at src/openhuman/tools/impl/browser/browser.rs:275

                if Self::rust_native_compiled() {
                    if let Some(err) = computer_use_err {
                        anyhow::bail!(
                            "browser.backend='auto' found no usable backend (playwright missing, agent-browser missing, rust-native unavailable, computer-use invalid: {err})"
                        );
                    }
                    anyhow::bail!(
                        "browser.backend='auto' found no usable backend (playwright missing, agent-browser missing, rust-native unavailable, computer-use sidecar unreachable)"
                    )
                }

                if let Some(err) = computer_use_err {
                    anyhow::bail!(
                        "browser.backend='auto' needs Playwright, agent-browser tool, browser-native, or valid computer-use sidecar (error: {err})"
                    );
                }

                anyhow::bail!(
                    "browser.backend='auto' needs Playwright, agent-browser tool, browser-native, or computer-use sidecar"
                )
            }
        }
    }

    /// Validate URL against allowlist
    fn validate_url(&self, url: &str) -> anyhow::Result<()> {
        let url = url.trim();

        if url.is_empty() {
            anyhow::bail!("URL cannot be empty");
        }

        // Block file:// URLs — browser file access bypasses all SSRF and
        // domain-allowlist controls and can exfiltrate arbitrary local files.
        if url.starts_with("file://") {
            anyhow::bail!("file:// URLs are not allowed in browser automation");

View on GitHub (pinned to 7491200858)

Solutions

  1. Install Playwright (`pnpm --filter openhuman-app exec playwright install chromium-headless-shell`) or agent-browser.
  2. Start and configure a computer-use sidecar.
  3. Pin browser.backend once one is available.
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at src/openhuman/tools/impl/browser/browser.rs:275 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of tinyhumansai/openhuman@7491200858 (2026-08-17). Data as JSON: /api/errors/dc181d21b7063dae. Report an issue: GitHub.