authloop

Python SDK for AuthLoop — human-in-the-loop authentication for AI agents.

When your browser agent (Playwright, Stagehand, Browser Use, OpenClaw, any CDP runtime) hits an auth wall it cannot solve — an SMS OTP, a behavioral CAPTCHA, a password prompt, a security question, an ID upload — the agent stops. AuthLoop replaces that stop with a 30-second handoff: the agent calls to_human(), the live tab streams to the user's phone, the user resolves the wall directly, and the agent continues. Credentials never touch our servers.

Install

pip install authloop

Usage

from authloop import AuthLoop

authloop = AuthLoop(api_key="al_live_...")

# When your agent hits an auth wall:
session = await authloop.to_human(
    service="HDFC NetBanking",
    cdp_url="ws://localhost:9222",
    context={"wall_type": "sms_otp", "hint": "OTP sent to ****1234"},
)

# Send session.session_url to the human (Telegram, Slack, etc.)
# Wait for the human to resolve it:
result = await authloop.wait_for_resolution(session.session_id)
# result.status == "RESOLVED" → agent continues

API

AuthLoop(api_key, base_url=None, runtime="other")

await authloop.to_human(...)

Creates a session and loops the auth to a human. Returns a ToHumanResult with session_id, session_url, stream_token, stream_url, expires_at.

wall_type is one of: "sms_otp", "email_otp", "totp", "password", "image_captcha", "behavioral_captcha", "security_question", "document_upload", "other".

await authloop.get_session(session_id)

Returns current session status: PENDING, ACTIVE, RESOLVED, TIMEOUT, ERROR, or CANCELLED.

await authloop.resolve_session(session_id)

Marks a session as resolved.

await authloop.cancel_session(session_id)

Cancels a session.

await authloop.wait_for_resolution(session_id, poll_interval=3.0, timeout=600.0)

Polls until the session reaches a terminal state. Returns the final SessionStatus.

Webhooks

AuthLoop fires a session.created webhook the moment you call to_human() so you can wake up 2am jobs, page on-call, or post to chat. Configure endpoints, view delivery logs, and grab the verify snippet from your dashboard → Webhooks.

Get an API Key

Sign up at authloop.ai — 50 free auth assists, no credit card required.

License

MIT