agentmb Python SDK

Python client for the agentmb daemon — local Chromium runtime for AI agents.

Install

pip install agentmb

Or from source (editable):

pip install -e sdk/python

Quick start

from agentmb import BrowserClient

with BrowserClient() as client:
    with client.sessions.create(profile="myprofile") as sess:
        sess.navigate("https://example.com")
        shot = sess.screenshot()
        shot.save("/tmp/out.png")

Async:

import asyncio
from agentmb import AsyncBrowserClient

async def main():
    async with AsyncBrowserClient() as client:
        sess = await client.sessions.create(profile="demo")
        async with sess:
            await sess.navigate("https://example.com")
            result = await sess.eval("document.title")
            print(result.result)

asyncio.run(main())

Action methods

File upload / download

# Upload
result = sess.upload("#file-input", "/path/to/file.csv", mime_type="text/csv")
print(result.filename, result.size_bytes)

# Download: triggers click, returns base64 file content
dl = sess.download("#download-link")
dl.save("/tmp/report.pdf")

Wait actions

# Wait for element to appear
sess.wait_for_selector("#modal", state="visible", timeout_ms=3000)

# Wait for URL after SPA navigation
sess.wait_for_url("**/dashboard**", timeout_ms=5000)

# Wait for a specific network response (with navigate trigger)
resp = sess.wait_for_response(
    url_pattern="/api/data",
    timeout_ms=10000,
    trigger={"type": "navigate", "url": "https://app.example.com"},
)
print(resp.status_code)

Requirements

• Python 3.9+
• agentmb daemon running (agentmb start)

Environment variables

License

MIT