agentauth-py 0.1.0

AI Agent session management SDK

AgentAuth

Persistent auth for AI agents. Works on any site, today.

No website integration required. No OAuth adoption needed. Just secure session management that works.

Quick Start • LangChain • Chrome Extension • Roadmap

---

The Problem

# What every agent developer does today
cookies = {"session_id": "abc123..."}  # Hardcoded. Breaks constantly. Security nightmare.

Sessions expire. Cookies leak into git history. No audit trail. No access control.

The Solution

from agent_auth import Vault

vault = Vault()
vault.unlock("password")
cookies = vault.get_session("linkedin.com")  # Encrypted. Scoped. Audited.

pip install agentauth-py

Works on sites as they exist today. No website changes. No OAuth adoption. No waiting for the ecosystem.

---

See It In Action

Agent automatically authenticates using stored session—no manual login, no hardcoded cookies.

---

How It Works

1. Export cookies with the Chrome extension while logged into any site
2. Store them in an encrypted vault (agent-auth add linkedin.com)
3. Your agent retrieves them securely on-demand

---

Quick Start

1. Initialize your vault

agent-auth init

2. Create an agent with scoped access

agent-auth create-agent sales-bot --scopes linkedin.com,gmail.com

3. Store a session

Export cookies with the Chrome extension, then:

agent-auth add linkedin.com
# Paste exported cookies

4. Use in your agent

from agent_auth import Agent, AgentAuthClient

agent = Agent.load("sales-bot")
client = AgentAuthClient(agent)
session = client.get_session("linkedin.com")

import requests
response = requests.get("https://linkedin.com/feed", cookies=session)

---

Why AgentAuth?

Without AgentAuth	With AgentAuth
Hardcoded cookies in code	Encrypted vault storage
Sessions in git history	Secrets separate from code
Any code can access anything	Scoped access per agent
No idea what accessed what	Full audit logging
Sessions break silently	Expiration notifications

---

LangChain Integration

from langchain_openai import ChatOpenAI
from langchain.agents import initialize_agent, AgentType
from agent_auth.langchain import get_agentauth_tools

tools = get_agentauth_tools(
    agent_name="sales-bot",
    vault_password="your-vault-password"
)

llm = ChatOpenAI(model="gpt-4", temperature=0)
agent = initialize_agent(
    tools=tools,
    llm=llm,
    agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION,
    verbose=True
)

# Agent automatically uses stored sessions
response = agent.run("Get my LinkedIn notifications")

Available tools:

• authenticated_request — Make HTTP requests with stored session cookies
• get_session_cookies — Retrieve cookies for custom requests

---

Playwright Integration

from playwright.sync_api import sync_playwright
from agent_auth import Vault

vault = Vault()
vault.unlock("password")
cookies = vault.get_session("github.com")

with sync_playwright() as p:
    browser = p.chromium.launch()
    context = browser.new_context()
    context.add_cookies(cookies)
    
    page = context.new_page()
    page.goto("https://github.com/notifications")
    # Already authenticated!

---

CLI Reference

Command	Description
agent-auth init	Initialize encrypted vault
agent-auth add <domain>	Add session for a domain
agent-auth list	List stored sessions
agent-auth create-agent <n> --scopes <domains>	Create scoped agent
agent-auth agents	List registered agents

---

Security

• AES-256 encryption with PBKDF2 key derivation (100k iterations)
• Ed25519 keypairs for agent identity
• Scoped access — agents only access approved domains
• Audit logging — every access logged with timestamp
• SQLite storage — encrypted database at ~/.agent-auth/vault.db

---

Roadmap

• Chrome extension for cookie export
• Encrypted local vault
• Playwright integration
• LangChain integration
• n8n integration (requested)
• Firefox extension
• Selenium examples
• Cloud vault sync

---

Examples

Working demos available in the examples/ folder.

GitHub Agent Demo

Setup:

# 1. Create the agent
agent-auth create-agent github-agent --scopes github.com

# 2. Export cookies from github.com using Chrome extension

# 3. Add the session
agent-auth add github.com

Run:

PYTHONPATH=. python examples/github_agent.py

---

Contributing

PRs welcome. Check out the issues for feature requests.

---

License

MIT

⭐ Star us if AgentAuth helps your agents authenticate!