Skip to main content

Reference

ParameterTypeDescriptionDefault
BROWSER_USE_API_KEYstrAPI key (or env var)Required
cloud_profile_idstrBrowser profile UUIDNone
cloud_proxy_country_codestrus, uk, fr, it, jp, au, de, fi, ca, inNone
cloud_timeoutintMinutes (max: 15 free, 240 paid)None
on_browser_createdCallableLive URL callbackNone
on_logCallableLog event callbackNone
on_resultCallableSuccess callbackNone
on_errorCallableError callbackNone

Example

@sandbox(
    cloud_profile_id='550e8400-e29b-41d4-a716-446655440000',
    cloud_proxy_country_code='us',
    cloud_timeout=60,
    on_browser_created=lambda data: print(f'Live: {data.live_url}'),
)
async def task(browser: Browser):
    agent = Agent(task="your task", browser=browser, llm=ChatBrowserUse())
    await agent.run()