fix Stagehand headless mode (#236)

shrey150 · web-flow · commit 9c9384feb38e · 2025-11-20T15:22:42.000-08:00
* fix Stagehand headless mode

* fix formatting
diff --git a/stagehand/browser.py b/stagehand/browser.py
@@ -182,7 +182,9 @@ async def connect_local_browser(
 
         # Prepare Launch Options (translate keys if needed)
         launch_options = {
-            "headless": local_browser_launch_options.get("headless", False),
+            "headless": local_browser_launch_options.get(
+                "headless", stagehand_instance.config.headless
+            ),
             "accept_downloads": local_browser_launch_options.get(
                 "acceptDownloads", True
             ),
diff --git a/stagehand/config.py b/stagehand/config.py
@@ -70,6 +70,7 @@ class StagehandConfig(BaseModel):
         alias="domSettleTimeoutMs",
         description="Timeout for DOM to settle (in ms)",
     )
+    headless: bool = Field(False, description="Run browser in headless mode")
     browserbase_session_create_params: Optional[dict[str, Any]] = Field(
         None,
         alias="browserbaseSessionCreateParams",

Original file line number	Diff line number	Diff line change
`@@ -70,6 +70,7 @@ class StagehandConfig(BaseModel):`
`70`	`70`	`alias="domSettleTimeoutMs",`
`71`	`71`	`description="Timeout for DOM to settle (in ms)",`
`72`	`72`	`)`
	`73`	`+ headless: bool = Field(False, description="Run browser in headless mode")`
`73`	`74`	`browserbase_session_create_params: Optional[dict[str, Any]] = Field(`
`74`	`75`	`None,`
`75`	`76`	`alias="browserbaseSessionCreateParams",`