Agent Quickstart

# Install uv (if not already installed)
pip install uv

# Create virtual environment
uv venv --python 3.12

# Activate environment
source .venv/bin/activate
# On Windows: .venv\Scripts\activate

# Install browser-use & chromium
uv pip install browser-use
uvx browser-use install

# Install Auth Agent SDK (includes browser-use integration)
uv pip install auth-agent-sdk

# Create .env file
touch .env
# On Windows: echo. > .env

# Auth Agent credentials
AGENT_ID=your_agent_id_here
AGENT_SECRET=your_agent_secret_here
AGENT_MODEL=browser-use  # or gpt-4, claude, etc.

# Browser-Use API key (get $10 free credits at https://cloud.browser-use.com/new-api-key)
BROWSER_USE_API_KEY=your_browser_use_api_key_here

from auth_agent_sdk.agent import AuthAgentTools

import os
import asyncio
from dotenv import load_dotenv
from browser_use import Agent, ChatBrowserUse
from auth_agent_sdk.agent import AuthAgentTools

# Load environment variables
load_dotenv()

async def main():
    """Run the Auth Agent authentication example."""
    
    # Initialize LLM
    llm = ChatBrowserUse()
    
    # Initialize Auth Agent tools with credentials from environment
    tools = AuthAgentTools(
        agent_id=os.getenv('AGENT_ID'),
        agent_secret=os.getenv('AGENT_SECRET'),
        model=os.getenv('AGENT_MODEL', 'browser-use'),
    )
    
    # Create the task
    task = (
        "Go to https://example.com/ai-auth/login "
        "and click on the 'Sign in with Auth Agent' button. "
        "When the spinning authentication page appears (shows 'Authenticating AI Agent' with a spinner), "
        "use the authenticate_with_auth_agent tool to complete the authentication. "
        "Wait for the page to redirect after authentication succeeds. "
        "Keep waiting until you reach the dashboard page - do not stop until you see the dashboard. "
        "Only use the 'done' tool when you have successfully reached and verified you are on the dashboard page."
    )
    
    # Create and run the agent
    agent = Agent(
        task=task,
        llm=llm,
        tools=tools,  # Pass the Tools instance directly
    )
    
    # Run the agent
    history = await agent.run()
    
    print("\n" + "="*60)
    print("Authentication Complete!")
    print("="*60)
    print("\nFinal result:")
    print(history.final_result() if hasattr(history, 'final_result') else history)

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