Python SDK

The infragrid package provides a synchronous client and ordered workflow builder for Python 3.10 or newer.

Version 0.1.0 is implemented in the source workspace but is not yet represented as published to PyPI.

Install

Source checkout
After PyPI release

python -m pip install -e /absolute/path/to/agentic-browser/packages/python-sdk

python -m pip install infragrid

Create a client

from infragrid import Infragrid

client = Infragrid()  # reads INFRAGRID_API_KEY

Constructor arguments:

Argument	Default	Purpose
`api_key`	`INFRAGRID_API_KEY`	Workspace server credential
`base_url`	`INFRAGRID_BASE_URL` or production API	Explicit preview or self-hosted URL
`max_retries`	2	Retries for safe or idempotent requests
`transport`	Standard-library HTTP transport	Custom request transport

Browser runs

created = client.runs.create(
    task="Open example.com and summarize it.",
    metadata={"jobId": "job_123"},
    idempotency_key="job-123-v1",
)

finished = client.runs.wait(
    created["id"],
    poll_interval=2.0,
    timeout=900.0,
    on_update=lambda run: print(run["status"], run["step_count"]),
)

Method	Purpose
`runs.create(...)`	Start exactly one task or workflow
`runs.get(run_id)`	Retrieve a run
`runs.list(limit=25, offset=0)`	List bounded run history
`runs.wait(run_id, ...)`	Poll to a terminal state
`runs.cancel(run_id)`	Cancel active work

Ordered workflows

finished = (
    client.workflow("pricing-review")
    .navigate("https://example.com")
    .extract("Return the page heading", name="heading")
    .run()
)

Python uses snake_case method names such as create_tab and keyword arguments such as click_count. See Ordered workflows.

Published Blueprints

blueprint = client.blueprints.list(limit=25)["data"][0]
started = client.blueprints.runs.create(
    blueprint["id"],
    {"account_id": "acct_123"},
    revision_id=blueprint["latestRevision"]["id"],
    idempotency_key="account-review-acct-123-v1",
)
finished = client.blueprints.runs.wait(started["id"])

The Blueprint runs client also supports get, list, events, and cancel.

Errors

All error classes derive from InfragridError and expose status, body, and request_id. Invalid JSON, malformed successful envelopes, timeouts, and unexpected transport failures fail closed as connection errors.

SDKs

Agent tools

Install

Create a client

Browser runs

Ordered workflows

Published Blueprints

Errors

​Install

​Create a client

​Browser runs

​Ordered workflows

​Published Blueprints

​Errors

Install

Create a client

Browser runs

Ordered workflows

Published Blueprints

Errors