agentauthlayer 0.1.1

Library-first authentication and authorization SDK for AI agents

Agent Auth SDK

A library-first authentication and authorization SDK for AI agents.

What this package is

agentauthlayer is the reusable Python SDK layer of the Agent Auth platform. It is designed for developers who want to:

• register agents
• issue and verify access with the Agent Auth control plane
• sync tool definitions
• evaluate permissions
• embed policy enforcement into agent runtimes

This package is the developer-facing library, not the full FastAPI server or React admin UI.

Install

pip install agentauthlayer

Quickstart

from agent_auth import AuthAPIClient

client = AuthAPIClient(
    base_url="http://127.0.0.1:8002",
    token="YOUR_ADMIN_OR_SERVICE_TOKEN",
)

agent = client.create_agent(
    agent_id="research-bot-01",
    name="Research Bot 01",
    owner="[e-mail]",
    role="research_agent",
    scopes=[],
    project_id="ai-platform",
)

print(agent)

Environment variables

If you prefer, the SDK reads these automatically:

export AGENT_AUTH_URL=http://127.0.0.1:8002
export AGENT_AUTH_TOKEN=YOUR_ADMIN_OR_SERVICE_TOKEN

Then:

from agent_auth import AuthAPIClient

client = AuthAPIClient()
print(client.health())

Common capabilities

Sync tools from code

client.sync_tools([
    {"action": "tool.search_web", "description": "Search the web"},
    {"action": "docs.read", "description": "Read protected docs"},
])

Evaluate access

decision = client.evaluate(
    principal_id="research-bot-01",
    action="tool.search_web",
    resource="web/*",
    role="research_agent",
)

print(decision)

Package scope

This package exposes the reusable SDK and policy primitives under agent_auth/. The full control plane server, admin UI, and demos remain in the same repository but are not part of the SDK package build.