Skip to main content

Lelu · Python SDK

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

Author: Abenezer Getachew
Maintainer: Abenezer Getachew

Installation

pip install lelu-agent-auth-sdk

Quick start

Run the local engine once — it self-generates its key and policy in ~/.lelu, no account needed:

npx -y lelu-mcp start

Then create one shared instance and import it everywhere. With no arguments, lelu() discovers that engine automatically:

import asyncio
from lelu import lelu

auth = lelu(actor="invoice_bot")   # zero-config: finds the local engine

async def main():
    result = await auth.authorize(tool="invoice:create")
    if result.decision == "allow":
        ...  # proceed
    elif result.decision == "human_review":
        # Queued for a human. Don't just wait for "approved" and then act —
        # an approval is bound to the request it approved, so pass the same
        # request back and let the engine confirm nothing changed.
        outcome = await auth.wait_and_redeem(result, tool="invoice:create")
        if not outcome.allowed:
            raise PermissionError(outcome.reason)
        ...  # proceed
    else:
        raise PermissionError(result.reason)

asyncio.run(main())

The instance exposes the full client as auth.api (tokens, review queue, audit, policies): await auth.api.mint_token(...).

Option 2: Self-hosted or cloud engine

Point the same factory at any engine with explicit config — or set LELU_BASE_URL / LELU_API_KEY and keep calling lelu() with no arguments:

auth = lelu(
    base_url="https://your-engine.example.com",
    api_key=os.environ["LELU_API_KEY"],
    actor="invoice_bot",
)

LeluClient(...) from earlier versions keeps working unchanged — auth.api is that same client.

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

Metadata

Release files for lelu-agent-auth-sdk 0.4.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lelu-agent-auth-sdk 0.4.4
File Size Uploaded Provenance Actions
lelu_agent_auth_sdk-0.4.4.tar.gz 58.2 kB Without provenance Details for lelu_agent_auth_sdk-0.4.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for lelu-agent-auth-sdk 0.4.4
File Interpreter ABI Platform Actions
lelu_agent_auth_sdk-0.4.4-py3-none-any.whl Python 3 none any Details for lelu_agent_auth_sdk-0.4.4-py3-none-any.whl

Total release size: 104.1 kB

Release files / lelu_agent_auth_sdk-0.4.4.tar.gz

Download URL lelu_agent_auth_sdk-0.4.4.tar.gz
Size 58.2 kB
Tags Source
SHA-256 checksum
How to use checksums
c5badd8483e4085b050efdd692d448ba2fe6862d77fd0b735dbb3a14d9096c97
BLAKE2b-256 checksum
How to use checksums
469833644f31c26cac2bbf2cd1d2527b4b315f2b044bac9e2b44b2ac2280db94
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / lelu_agent_auth_sdk-0.4.4-py3-none-any.whl

Download URL lelu_agent_auth_sdk-0.4.4-py3-none-any.whl
Size 45.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
880f08ee7a830a1f55aba821f0f2cedd492bb1d1b2c7f93bc1b046c856fbd5a6
BLAKE2b-256 checksum
How to use checksums
cf6e5b238c038a0b97fb3be538069c39cf21f86d9e9ff8e3fb52e1f8a16a3a65
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for lelu-agent-auth-sdk 0.4.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page