BabelWrap Python SDK

The official Python client for the BabelWrap API — the web, as an API, for your agents.

BabelWrap lets AI agents interact with any website through a simple API. This SDK provides sync and async Python clients.

Installation

pip install babelwrap

Quick Start

from babelwrap import BabelWrap

with BabelWrap(api_key="bw_...") as bw:
    with bw.create_session() as session:
        snap = session.navigate("https://example.com")
        print(snap.title)

        # Interact with the page
        session.click("the Login button")
        session.fill("Email address field", "user@example.com")
        session.submit()

        # Extract structured data
        data = session.extract("all product names and prices")
        print(data)

Async Usage

from babelwrap import AsyncBabelWrap

async with AsyncBabelWrap(api_key="bw_...") as bw:
    async with await bw.create_session() as session:
        snap = await session.navigate("https://example.com")
        print(snap.title)

        data = await session.extract("all links on the page")

Features

• Sync and async clients
• Automatic retries with exponential backoff on transient errors
• Context managers for automatic session cleanup
• Typed snapshots with attribute access (snap.title, snap.inputs, snap.actions)
• Site mapping — discover and generate tools for any website

API Reference

BabelWrap / AsyncBabelWrap

Session / AsyncSession

Documentation

Full documentation at babelwrap.com/docs

License

MIT