Human in the loop

Use a human checkpoint for approvals, authentication, payments, or review. Get its live_view_url with the SDK’s event-wait helper, which follows event cursors and also returns browser.reattached when a follow-up reused the open browser. Wait for the run to stop at the checkpoint before letting a person interact:

from browser_use_sdk.v4 import BrowserUse

client = BrowserUse()
run = client.runs.create(
    "Open the login page and stop for human review",
    keep_alive=900,
)
ready = client.runs.wait_for_event(run.id, "browser.ready")
client.runs.wait_for_completion(run.id)
print(ready.data["live_view_url"])

input("Press Enter after finishing the human step...")
next_run = client.runs.create(
    "Continue from the current page",
    session_id=run.session_id,
)

import { BrowserUse } from "browser-use-sdk/v4";
import * as readline from "node:readline/promises";

const client = new BrowserUse();
const run = await client.runs.create({
  task: "Open the login page and stop for human review",
  model: "gpt-5.6-luna",
  modelParams: { reasoning: { effort: "xhigh" } },
  keepAlive: 900,
});
const ready = await client.runs.waitForEvent(run.id, "browser.ready");
await client.runs.waitForCompletion(run.id);
console.log(ready.data.live_view_url);

const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
await rl.question("Press Enter after finishing the human step...");
rl.close();
const nextRun = await client.runs.create({
  task: "Continue from the current page",
  model: "gpt-5.6-luna",
  modelParams: { reasoning: { effort: "xhigh" } },
  sessionId: run.sessionId,
});

The first run ends and the browser stays open for up to keepAlive 900 seconds. A human uses the live_view_url in that browser, then a follow-up run with the same session_id continues on the same page.

The same session keeps the conversation and workspace. Without keepAlive, its browser stops about 2 minutes after the run ends, and the follow-up starts on a fresh browser without the human’s page state. A keepAlive of 900 keeps it open for 15 minutes; the follow-up inherits the value, and kept time is billed. The typed keep_alive / keepAlive needs SDK 3.12+; see Sessions for 3.11.3. In a web app, replace the terminal prompt with an explicit Continue control. Treat live-view URLs as credentials.

Get Started

Pillars

More