2.9 KiB
title, type, status, created, updated, verified_on, confidence, tags, sources
| title | type | status | created | updated | verified_on | confidence | tags | sources | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Browser Automation | concept | active | 2026-07-22 | 2026-11-20 | 2026-11-20 | high |
|
|
Browser Automation
Idea
Giving an agent a real, controllable web browser — as opposed to just an HTTP-fetch tool — so it can handle JS-heavy pages, logins, and visual verification.
How this install implements it
- Engine: Camoufox (Firefox-based, fingerprint-resistant) — see comparisons/camoufox-vs-chrome for why this over stock Chrome.
- Connection: REST API and CDP WebSocket on the same service at
localhost:9377(profileanthony). Corrected 2026-10-13 — earlier revisions split this across:9093(REST) and:9377(WS); nothing listens on:9093. - Display: headed, not truly headless — runs under
Xvfb :99(1600×1200×24) withfluxboxas window manager, viewable live over VNC (see systems/headless-server). - Config:
cloud_provider: camofox,camera_provider: camofoxin~/.hermes/config.yaml - Auth: Persistent profile
anthony— authenticated into Uber Eats, LinkedIn, etc. No cookie files needed.
Why headed-under-Xvfb instead of headless
Running a real X display (rather than a headless browser flag) lets a human watch/intervene via VNC and tends to reduce automation-detection fingerprints compared to headless-mode flags — consistent with using Camoufox in the first place. The tradeoff, flagged in systems/headless-server, is that the VNC exposing this display currently has no password.
The Steel Experiment (Jul 29–30)
Steel Browser (Chromium 140 on CT201) was briefly the primary backend. It offered full CDP access and a built-in session viewer, but was reverted after:
- CDP URL normalization issues (Docker internal networking required a plugin patch)
- Empty-stream errors from the
opencode-go/deepseek-v4-flashprovider path - DeepSeek 0731's stricter tool name validation affected all providers
Lesson: A local browser backend (same host, no network hop) has fewer failure modes than a remote Docker container. The browser-steel plugin was deleted on 2026-10-29 and the Steel deployments on CT201 and CT333 were torn down, so there is no Steel fallback left to fall back to — Camofox is the only backend. See comparisons/steel-vs-camoufox and decisions/rollback-steel-to-camofox.
Re-verified 2026-11-20 (stocktake). Camofox service active on CT460 (
systemctl --user),:9377/health→ok; Xvfb:99at 1600×1200×24 with fluxbox, websockify on 127.0.0.1:6080. Configcloud_provider: camofox/camera_provider: camofoxconfirmed. No Steel anywhere (CT201/CT333 containers, images, routes, plugin all re-probed absent).