Python SDK - Infragrid Docs

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

Install

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.

Last modified on August 17, 2026