WARHOUNDOPEN SOURCEGitHub
Projects / Browser infrastructure

HoundBrowser.

Let your agent use the browser.
Keep the machine out of reach.

An API-first browser runtime with scoped actions, structured observations, read-only live viewing, and inspectable evidence. Bring your own model and orchestration.

Apache 2.0Python 3.11+Chromium
HoundBrowser API / v1
01
Your agentAny model. Your orchestration.
intent
02
Scoped browser APIAuthenticate · validate · execute
boundary
03
An isolated browserObserve the page. Take an action.
runtime
DOM observationsLive framesEvidence
No shell accessNo exposed CDP
01

Observe

Structured page text and revision-scoped element handles. Read what changed before deciding what to do next.

02

Act

Navigation, forms, tabs, keyboard, scoped HTTP, and controlled page evaluation through one command protocol.

03

Verify

Screenshot artifacts with SHA-256 integrity, explicit command outcomes, and events you can inspect.

FIRST SESSION

A browser API.
Not another model SDK.

Use the Python client, JavaScript, or HTTP. Keep your agent framework, inference provider, and resource budgets.

Agent integration guide
with Client(endpoint, api_key=key) as browser:
    session = browser.create("https://example.com")
    try:
        result = browser.run(
            session["id"], "navigate",
            {"url": "https://example.com"}
        )
        print(result["result"]["title"])
    finally:
        browser.close(session["id"])
GITHUB RELEASES

Checking published releases

Release notes appear here after a release is published on GitHub.

View releases on GitHub