Browser Hand

# macOS
brew install python3

# Windows
winget install Python.Python.3.12

# Linux (Ubuntu/Debian)
sudo apt install python3

# Linux (Fedora)
sudo dnf install python3

# Linux (Arch)
sudo pacman -S python

# Install Playwright
pip install playwright

# Install browser binaries (required)
playwright install chromium

openfang hand activate browser

openfang hand config browser \
  --set headless="false" \
  --set max_pages_per_task="20" \
  --set screenshot_on_action="true"

> Search Amazon for "mechanical keyboards under $100" and show me the top 3 results with prices

> Fill out the contact form at https://example.com/contact with:
Name: John Doe
Email: [email protected]
Message: Interested in learning more about your product

Take a screenshot before submitting for my review.

> Go to TechCrunch, find the latest article about AI agents, and summarize it

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=True)
    page = browser.new_page()
    
    # Session persists - cookies, login state maintained
    page.goto("https://example.com")
    # ... interact ...
    
    browser.close()

browser_navigate({url: "https://amazon.com"})

browser_read_page()
// Returns: page title, URL, visible text, form structure

URL: https://amazon.com/s?k=mechanical+keyboards
Title: Amazon.com: mechanical keyboards

Visible text:
Mechanical Keyboards
Results 1-48 of 2,000+

Logitech MX Mechanical
$149.99
★★★★☆ 4.3 (1,234)

Keychron K2
$89.99
★★★★★ 4.7 (5,678)
...

// By CSS selector
browser_click({selector: "button[type='submit']"})

// By visible text
browser_click({text: "Add to Cart"})

browser_type({selector: "input[name='q']", text: "mechanical keyboards"})

browser_screenshot({filename: "search_results.png"})

browser_close()

browser_click({text: "Add to Cart"}) // Clicks element with visible text

Browser Hand:
"I'm ready to complete your purchase. Here's what's in the cart:

1. Keychron K2 Mechanical Keyboard - $89.99
2. USB-C Cable - $12.99

Subtotal: $102.98
Shipping: $5.99
Tax: $8.24
Total: $117.21

Shipping to: 123 Main St, San Francisco, CA 94102
Payment: Visa ending in 1234

Do you want me to complete this purchase? (yes/no)"

User: "yes"

Browser Hand:
[Proceeds to click "Place Order"]
"Order placed! Confirmation number: #ABC123456"

Error: Selector "#search-box" not found

Recovery:
1. Try alternative selector: input[type="search"]
2. Try visible text: browser_click({text: "Search"})
3. Take screenshot to debug
4. Inform user

Error: Navigation timeout

Recovery:
1. Wait and retry: browser_navigate({url})
2. Check if URL is correct
3. Inform user of issue

Detected: CAPTCHA or human verification

Action:
1. Inform user: "Site requires CAPTCHA - I cannot solve these automatically"
2. Suggest: "Please complete CAPTCHA manually if headless=false"
3. Wait for user confirmation to continue

Compare prices for "Sony WH-1000XM5" on Amazon, Best Buy, and B&H Photo

Go to https://example.com/schedule and check available appointment slots for next Tuesday

Fill out the newsletter signup at https://example.com with email: [email protected]
Take a screenshot before submitting.

Go to YCombinator's latest batch page and list the top 10 companies with their descriptions

Check if https://example.com/product is in stock and notify me

1. Go to Hacker News
2. Find the top story
3. Click through to the article
4. Summarize the content
5. Return to HN and check the comment thread
6. Summarize top 3 comments

Check if the product is in stock.
If yes, add to cart and show me the total.
If no, sign up for restock notifications.

Every day at 9 AM, check https://example.com/deals for new deals matching "laptop" and notify me