Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/cloudwaddie/lmarenabridge/llms.txt

Use this file to discover all available pages before exploring further.

LMArena Bridge launches real browser instances to solve Cloudflare Turnstile challenges, mint reCAPTCHA tokens, and stream responses from LMArena. Three separate configuration fields control how each browser window appears on screen. In production all three default to "hide" so the bridge runs completely headless. During debugging you can switch individual windows to "visible" to watch exactly what the browser is doing.

​
The three window mode settings

Config fieldBrowser processDefault
camoufox_proxy_window_modeCamoufox — anonymous signup and Turnstile challenge solving"hide"
camoufox_fetch_window_modeCamoufox — streaming fetch transport"hide"
chrome_fetch_window_modeChrome or Edge — streaming fetch transport"hide"
Each field is independent. You can, for example, keep the Camoufox fetch window hidden while making the Chrome window visible to watch reCAPTCHA handling.

​
Valid values

All three fields accept the same set of values: 
{
    "camoufox_proxy_window_mode": "hide",
    "camoufox_fetch_window_mode": "hide",
    "chrome_fetch_window_mode": "hide"
}
The full list of accepted strings:
ValueAliasesBehaviour
"hide""hidden"Window is not shown. Equivalent to headless mode for that process.
"minimize""minimized"Window is created and then immediately minimized to the taskbar.
"offscreen""off-screen", "moveoffscreen", "move-offscreen"Window is moved outside the visible screen area.
"visible"—Window appears on screen at normal size. Use for debugging.
The aliases ("hidden", "minimized", "off-screen", etc.) are accepted and treated as identical to their canonical forms. Prefer the canonical forms ("hide", "minimize", "offscreen", "visible") for clarity.

​
Which process does each setting control?

​
camoufox_proxy_window_mode — anonymous signup

The Camoufox proxy worker is a singleton background browser that handles anonymous user signup on LMArena. It solves Cloudflare Turnstile challenges to obtain provisional user tokens. This window is only opened when the bridge needs to mint a new anonymous session, not on every request.

​
camoufox_fetch_window_mode — Camoufox transport

The Camoufox fetch transport uses a Firefox-based Camoufox browser to execute fetch() calls directly inside the page. This transport is used as a fallback when Chrome-based reCAPTCHA solving fails repeatedly, or when Camoufox is explicitly selected for a request.

​
chrome_fetch_window_mode — Chrome transport

The Chrome fetch transport uses a real Chrome or Edge browser via Playwright to execute fetch() in-page. This is the primary transport for models that require reCAPTCHA v3 token injection. On Windows the bridge looks for Chrome and Edge in the standard installation paths.

​
When to use each value

Leave all three settings at the default "hide". The bridge runs fully headless and does not require a display server.
{
    "camoufox_proxy_window_mode": "hide",
    "camoufox_fetch_window_mode": "hide",
    "chrome_fetch_window_mode": "hide"
}

​
Applying changes

Window mode settings are read each time a browser instance is launched. Changes to config.json take effect the next time that browser process is started — you do not need to restart the entire bridge server, but any already-running browser windows will continue using the mode they were launched with.

Build docs developers (and LLMs) love

Get started for freeTalk to us