agentauth-py 0.2.1

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 • n8n • How It Works • 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()
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. Log into any site in Chrome (you probably already are)
2. Run agent-auth grab <domain> — cookies are encrypted and stored locally
3. Your agent retrieves them securely on-demand

No extension required. No copy-paste. One command.

---

Quick Start

pip install agentauth-py
agent-auth grab linkedin.com

That's it. Your LinkedIn session is now stored in an encrypted vault.

The grab command reads cookies directly from Chrome—no extension needed, no manual export.

from agent_auth import Vault

vault = Vault()
cookies = vault.get_session("linkedin.com")

# Use with requests, Playwright, or any HTTP library
import requests
response = requests.get("https://linkedin.com/feed", cookies=cookies)

Works with any site you're logged into:

agent-auth grab github.com
agent-auth grab notion.so
agent-auth grab twitter.com

---

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"  # Password auto-retrieved from system keyring if not provided
)

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

---

n8n Integration

Use AgentAuth in your n8n workflows with our community node.

npm install n8n-nodes-agentauth

The node lets you:

• Store and retrieve session cookies in n8n workflows
• Use authenticated sessions with HTTP Request nodes
• Build automation flows that require login

📦 View on npm | GitHub

---

Playwright Integration

from playwright.sync_api import sync_playwright
from agent_auth import Vault

vault = Vault()
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 grab <domain>	Grab cookies directly from Chrome
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
• Direct Chrome cookie extraction (agent-auth grab)
• Playwright integration
• LangChain integration
• n8n integration — n8n-nodes-agentauth
• 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!