> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pre.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser Agents SDKs

> Run, retrieve, list, and stream browser work with the official predev-api packages.

Browser Agents uses the same **`predev-api`** packages as the Architect API.

| Operation               | Node                                 | Python                                        |
| ----------------------- | ------------------------------------ | --------------------------------------------- |
| Run tasks               | `browserAgent(tasks, options)`       | `browser_agent(tasks, ...)`                   |
| Submit asynchronously   | `{ async: true }`                    | `run_async=True`                              |
| Stream a new submission | `{ stream: true }` → async generator | `stream=True` → iterator                      |
| Retrieve a run          | `getBrowserAgent(id, options)`       | `get_browser_agent(id, include_events=False)` |
| List runs               | `listBrowserAgents(params)`          | `list_browser_agents(...)`                    |
| Read account queue      | `browserAgentStatus()`               | `browser_agent_status()`                      |

Node returns objects and Python returns dictionaries. Both expose typed browser gate exceptions. The Python SDK is blocking even when submitting a server-side async job.

<CardGroup cols={2}>
  <Card title="Node.js" icon="node-js" href="/browser-agents/sdks/node">
    Promises, async generators, and current TypeScript field coverage.
  </Card>

  <Card title="Python" icon="python" href="/browser-agents/sdks/python">
    Dictionary results, bounded polling, and streaming iterators.
  </Card>
</CardGroup>

Use direct REST for `Idempotency-Key`, [existing-run SSE](/browser-agents/api/stream-task), [live browser URLs](/browser-agents/api/live-browser), or [service capacity](/browser-agents/api/capacity). Current SDK method signatures do not expose these operations or arbitrary headers.
