tinyhumansai/openhuman · error

browser.backend='{}' but agent-browser is unavailable. Insta

Error message

browser.backend='{}' but agent-browser is unavailable. Install it in your environment.

What it means

resolve_backend fails when the config explicitly pins browser.backend='agent-browser' but the agent-browser tool is not installed/reachable in the environment. Unlike 'auto', a pinned backend is never substituted, so the missing dependency is reported directly.

Source

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

        }

        Ok(parsed)
    }

    fn computer_use_available(&self) -> anyhow::Result<bool> {
        let endpoint = self.computer_use_endpoint_url()?;
        Ok(endpoint_reachable(&endpoint, Duration::from_millis(500)))
    }

    async fn resolve_backend(&self) -> anyhow::Result<ResolvedBackend> {
        let configured = self.configured_backend()?;

        match configured {
            BrowserBackendKind::AgentBrowser => {
                if Self::is_agent_browser_available().await {
                    Ok(ResolvedBackend::AgentBrowser)
                } else {
                    anyhow::bail!(
                        "browser.backend='{}' but agent-browser is unavailable. Install it in your environment.",
                        configured.as_str()
                    )
                }
            }
            BrowserBackendKind::Playwright => {
                if Self::is_playwright_available().await {
                    Ok(ResolvedBackend::Playwright)
                } else {
                    anyhow::bail!(
                        "browser.backend='playwright' but Playwright is unavailable. Ensure app/node_modules is installed, run `pnpm --filter openhuman-app exec playwright install chromium-headless-shell`, or set OPENHUMAN_PLAYWRIGHT_CWD."
                    )
                }
            }
            BrowserBackendKind::RustNative => {
                if !Self::rust_native_compiled() {
                    anyhow::bail!(
                        "browser.backend='rust_native' requires build feature 'browser-native'"

View on GitHub (pinned to 7491200858)

Solutions

1. Install agent-browser in the environment.
2. Switch browser.backend to 'auto' or 'playwright' in config.toml.
3. Fix PATH so the agent-browser binary is discoverable.

When it happens

Trigger: Thrown at src/openhuman/tools/impl/browser/browser.rs:205 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/658734fd257628ce. Report an issue: GitHub.