aimlib 0.4.2

Python SDK for aimlib mobile proxies and remote-browser sessions

aimlib Python SDK

Asynchronous Python client for aimlib mobile proxies, on-device remote-browser sessions, radio operations, and support tickets. Python 3.10 or newer is required.

Install

For proxy, device, radio-operation, and support APIs:

python -m pip install --upgrade aimlib

Include managed remote-browser support when needed:

python -m pip install --upgrade "aimlib[browser]"

The browser extra connects to Chromium on the leased phone. It does not download or launch a browser binary on your computer.

Configure

export AIMLIB_API_KEY="<api-key>"
export AIMLIB_BASE_URL="https://uswest1.aimlib.com"

API keys, credential-bearing proxy URLs, and browser connection tokens are secrets. Do not print or log them.

Example

from aimlib import Aimlib

async with Aimlib() as ai:
    device = (await ai.devices.list())[0]

    http_proxy = device.proxy.http_url
    socks_remote_dns_proxy = device.proxy.socks5h_url

    async with await device.browser(ttl="10m") as session:
        page = await session.new_page()
        await page.goto("https://example.com")
        print(await page.title())

Only devices in your active rentals are returned. A remote browser can be created only after a rental is active and the phone has been assigned to it.

Main APIs

• ai.devices.list() and ai.device(id) return devices in active rentals.
• device.proxy.http_url, .socks5_url, and .socks5h_url address the same proxy host and port.
• device.browser() creates a remote-browser session for the active rental.
• session.new_page(), .disconnect(), .connect(), and .stop() manage that session.
• device.rotate_ip() and device.switch_carrier() support blocking or queued operation modes.
• ai.operations.get(id) and .wait(id) poll queued radio operations.
• ai.tickets creates, lists, reads, replies to, and closes support tickets.

Development

python -m pip install -e ".[browser]"
python -m unittest discover -s tests -v

See the customer documentation for the complete API contract, limits, security policy, and examples. Release notes are kept in the changelog.

Report security issues privately as described in the security policy. Never include API keys, credential-bearing proxy URLs, browser connection tokens, or customer data in an issue or log.