Nomad SDK — Python

Nomad is a zero-overhead headless browser engine. 5 MB binary, 6 MB RSS, 550 req/s. This package connects to a running Nomad daemon over a Unix Domain Socket.

pip install nomad-sdk

Quickstart

Make sure the Nomad daemon is running:

MALLOC_ARENA_MAX=1 nomad-daemon &

Then scrape a page in 2 lines:

from nomad_sdk import NomadClient

with NomadClient() as client:
    page = client.navigate("https://news.ycombinator.com")
    print(f"Title: {page.title}")
    print(f"Links: {len(page.find_all(tag='a'))}")

API

NomadClient(socket_path="/tmp/nomad-daemon.sock")

Output formats (fmt)

Page methods

page.find_one(role="button", text="Sign In")  # first match
page.find_all(tag="a", intent="navigation")    # all matches

Example — Click a button

from nomad_sdk import NomadClient

with NomadClient() as client:
    page = client.navigate("https://example.com/login")
    btn = page.find_one(role="button", text="Submit")
    if btn:
        client.click(btn.id)

Requirements

• Python ≥ 3.10
• Nomad daemon running (UDS socket at /tmp/nomad-daemon.sock)