Metadata-Version: 2.4
Name: agentauth
Version: 0.1.0
Summary: Automated authentication for web agents
Author: Cole Hecht
License-File: LICENSE.txt
Requires-Python: >=3.11
Requires-Dist: browser-use>=0.1.36
Requires-Dist: browserbase>=1.1.0
Requires-Dist: imap-tools>=1.10.0
Requires-Dist: pyotp>=2.9.0
Requires-Dist: python-dotenv>=1.0.1
Description-Content-Type: text/markdown

# AgentAuth

AgentAuth is a Python package that helps automate web authentication. It supports various authentication methods including email magic links, email verification codes, TOTP, and standard username/password login.

# Usage

```python
from agentauth import AgentAuth

aa = AgentAuth(
    credentials_file="credentials.json",
    IMAP_SERVER="imap.example.com",
    IMAP_USERNAME="agent@example.com",
    IMAP_PASSWORD="agent_email_password"
)

cookies = await aa.auth(
    "https://example.com",
    "agent@example.com",
    cdp_url="wss://..." # Optional, but services like Browserbase are helpful to avoid bot detection
)

# Use cookies for authenticated agent actions
```

# To Do

- [x] Look at package managers
- [x] Add license
- [x] Add example: browser-use
- [x] Add example: playwright
- [x] Add example: browserbase (cdp)
- [ ] Publish to pip
- [ ] Add 1Password integration
- [ ] Add Bitwarden integration
- [ ] Use local LLM for email scanning
- [ ] Allow other LLMs
