auth-agent

AI-driven browser automation agent with a LangGraph workflow, Selenium execution, interruption detection (CAPTCHA/OTP/MFA), and human-in-the-loop pause/resume.

Build / install

python -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -r requirements.txt

Configure

Create a .env file (or export env vars):

cp .env.example .env

Run (smoke)

This runs a minimal workflow that opens a URL, looks for common auth challenges, and pauses for human input when needed.

python -m auth_agent.cli --url "https://example.com" --headful

Notes

• This repo provides a framework for resilient auth-aware automation; you’ll still need to author site-specific steps/selectors for real targets.
• CAPTCHA solving is intentionally human-in-the-loop; the agent will pause and wait for you to complete it in the opened browser.