lelu-agent-auth-sdk 0.3.6

Python SDK for Lelu — framework-agnostic authorization engine for AI agents with confidence-aware controls, Docker deployment, and human-in-the-loop workflows

Lelu · Python SDK

Python client for Lelu — the confidence-aware authorization engine for autonomous AI agents.

Author: Abenezer Getachew

Installation

pip install lelu-agent-auth-sdk

Or run the public Lelu engine image:

docker pull abenezer0923/lelu-engine:latest
docker run --rm -p 8083:8080 abenezer0923/lelu-engine:latest

Quick start

Option 1: Use Hosted Engine (Recommended)

Connect to the hosted Lelu engine for instant setup:

import asyncio
from lelu import LeluClient, AgentAuthRequest, AgentContext

async def main():
    async with LeluClient(base_url="https://lelu-engine.onrender.com") as client:
        result = await client.agent_authorize(AgentAuthRequest(
            actor="invoice_bot",
            action="invoice:create",
            context=AgentContext(
                confidence=0.92,
                acting_for="user_123",
            ),
        ))
        print(result.allowed, result.reason)

asyncio.run(main())

Option 2: Run Locally

For development, you can run the engine locally:

import asyncio
from lelu import LeluClient, AgentAuthRequest, AgentContext

async def main():
    async with LeluClient(base_url="http://localhost:8082") as client:
        result = await client.agent_authorize(AgentAuthRequest(
            actor="invoice_bot",
            action="invoice:create",
            context=AgentContext(
                confidence=0.92,
                acting_for="user_123",
            ),
        ))
        print(result.allowed, result.reason)

asyncio.run(main())

Start the local engine with Docker:

docker compose up -d

API

Method	Description
agent_authorize(req)	Confidence-aware agent authorization
authorize(req)	Human RBAC authorization
mint_token(req)	Mint a JIT-scoped JWT
revoke_token(token_id)	Revoke a token immediately
is_healthy()	Health-check the engine

License

MIT