Ant0 Browser SDK for Python

A Playwright-compatible SDK for launching a separately installed Ant0 Browser engine from Python.

Python SDK guide · Support

The ant0-browser package contains the SDK, not the browser engine, an Ant0 account or licence, or synthetic-identity assets. SDK code is BSD-3-Clause licensed; the engine is installed and licensed separately.

Before you install

Direct SDK launches require all of the following:

1. Install the Ant0 application and its licensed Ant0 Browser engine.
2. Complete sign-in in the Ant0 application; its local ant0d daemon uses that signed-in, licensed state to provide launch tickets.
3. Set ANT0_BROWSER_BINARY to the absolute path of that installation's engine executable before starting Python.

The SDK checks that the executable is an Ant0 build; stock Chrome or Chromium is not a substitute. SDK package version 0.1.1 and the installed engine release version are independent.

Install

python -m pip install ant0-browser==0.1.1

Package metadata declares Python 3.9 or newer. See the qualification table below for tested environments. Do not run playwright install: the SDK uses the separately installed Ant0 engine, not Playwright's stock browser downloads.

Quick start: synchronous API

Save as example.py and run python example.py. This native-identity example needs no synthetic assets.

from ant0browser import launch


def main():
    browser = launch(identity={"mode": "native"})
    try:
        page = browser.new_page()
        page.goto("https://example.com")
        print(page.title())
    finally:
        browser.close()


if __name__ == "__main__":
    main()

Quick start: asynchronous API

Save as example_async.py and run python example_async.py.

import asyncio

from ant0browser.async_api import launch


async def main():
    browser = await launch(identity={"mode": "native"})
    try:
        page = await browser.new_page()
        await page.goto("https://example.com")
        print(await page.title())
    finally:
        await browser.close()


if __name__ == "__main__":
    asyncio.run(main())

launch() creates a temporary profile by default and removes it when the browser closes or the process exits. Use launch_persistent_context() when you intentionally need a persistent profile.

API at a glance

Omitting identity selects native identity. Captured or synthetic identities and explicit overrides are also available; creating a new synthetic identity requires separately authorized local model or template assets. Those assets are not included in the package.

Proxy, network, and privacy

Proxy settings for browser launches are optional and follow Playwright's configuration. SOCKS5 username/password authentication is not supported by the engine; use an HTTP(S) proxy with credentials, an unauthenticated SOCKS5 proxy, or Ant0's local relay. GeoIP exit-IP lookups use an HTTP(S) proxy; SOCKS proxies are not supported for that lookup.

See SDK network details and the Ant0 Privacy Policy for more information. resolve_geo() is optional; ordinary browser navigation follows the URLs your code opens.

Runtime and qualification

The package declares Python >=3.9. Qualification so far covers the combinations below; the declared minimum is not a claim that every minimum-version/platform combination has been tested.

The engine used for native launch qualification was 154.0.8037.57-ant0.2.

Troubleshooting

GeoIP attribution

Optional GeoIP uses the IP2Location LITE database (ip2location.com), includes GeoLite2 data created by MaxMind (maxmind.com), and includes IP geolocation by DB-IP (db-ip.com). The merged geoip-all-in-one database is GPL-3.0; its data covers country, coordinates, and timezone.

More information

• Python SDK guide and API reference
• Identity options
• Network behavior
• Support
• Privacy Policy