Talk2Dom Python SDK

PyPI Stars License

Minimal client SDK to call the Talk2Dom API.

Install

pip install talk2dom
# optional
pip install "talk2dom[selenium]"
# or
pip install "talk2dom[playwright]"

## Quiack Start
from talk2dom import Talk2DomClient

client = Talk2DomClient(
  api_key="YOUR_API_KEY",
  project_id="YOUR_PROJECT_ID",
)

# sync example
res = client.locate("click the primary login button", html="<html>...</html>", url="https://example.com")

# async exmaple
res = client.alocate("click the primary login button", html="<html>...</html>", url="https://example.com")

Environment variables

T2D_API_KEY
T2D_PROJECT_ID
T2D_ENDPOINT (optional; defaults to https://api.talk2dom.itbanque.com)

Selenium ActionChains

from selenium import webdriver

import time
from talk2dom.selenium import ActionChains

driver = webdriver.Chrome()

driver.get("https://python.org")

actions = ActionChains(driver)

actions\
    .go("Type 'pycon' in the search box")\
    .go("Click the 'go' button")

time.sleep(2)

Playwright PageNavigator

from playwright.sync_api import sync_playwright
from talk2dom.playwright import PageNavigator


def main():
    with sync_playwright() as p:
        # Launch Chromium browser
        browser = p.chromium.launch(headless=False)
        page = browser.new_page()

        navigator = PageNavigator(page)

        # Navigate to python.org
        page.goto("https://www.python.org")

        navigator.go("Type 'pycon' in the search box")

        navigator.go("Click the 'go' button")

        # Wait for results to load
        page.wait_for_timeout(3000)

        # Close the browser
        browser.close()


if __name__ == "__main__":
    main()

Metadata

Release files for talk2dom 0.3.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for talk2dom 0.3.5
File	Size	Uploaded
talk2dom-0.3.5.tar.gz	16.3 kB	Sep 13, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for talk2dom 0.3.5
File	Interpreter	ABI	Platform	Reset
talk2dom-0.3.5-py3-none-any.whl 16.5 kB Sep 13, 2025	Python 3	none	any	Details

Total release size: 32.8 kB

Release files / talk2dom-0.3.5.tar.gz

Download URL	talk2dom-0.3.5.tar.gz
Size	16.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`9cf731407fc2c7c906fa1c9eaabcbde61847bbbf7da6e8a483ba196b323942de`
BLAKE2b-256 checksum How to use checksums	`565c70feb90742b471f3208798566be66a0bbb75d96d483844cf8f04d530e914`
Upload date	Sep 13, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.11`

Release files / talk2dom-0.3.5-py3-none-any.whl

Download URL	talk2dom-0.3.5-py3-none-any.whl
Size	16.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7f4bb73effc66436f6a0ec7b0cfb0739431cd64b0af6825f0b7af71684851bf6`
BLAKE2b-256 checksum How to use checksums	`33aaddca61543df10f87f90c69f74e9925cc4d0254f80fcccb6dd62e20e281cf`
Upload date	Sep 13, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.11`