Installation

1Choose Installation Method

Lelu can be installed in two ways: using Docker (recommended for quick start) or by installing SDKs directly.

# Pull and run all services
docker pull leluauth/lelu-engine:latest
curl -O https://raw.githubusercontent.com/lelu-auth/lelu/main/docker-compose.production.yml
docker-compose -f docker-compose.production.yml up -d

# TypeScript/JavaScript
npm install @lelu-auth/lelu

# Python
pip install auth-pe

2Install the Package

Let's start by adding Lelu to your project:

npm install @lelu-auth/lelu

3CLI Commands

After installing, you can use the built-in CLI commands to view audit logs and manage policies directly from your terminal:

# View audit logs
npx @lelu-auth/lelu audit-log

# Manage policies
npx @lelu-auth/lelu policies list
npx @lelu-auth/lelu policies get auth
npx @lelu-auth/lelu policies set auth ./auth.rego

# After installing: pip install lelu-agent-auth-sdk
lelu audit-log
lelu policies list
lelu policies get auth
lelu policies set auth ./auth.rego

# Build and run CLI
cd sdk/go/cmd/lelu
go build -o lelu
./lelu audit-log
./lelu policies list

4Set Environment Variables

Create a .env file in the root of your project and add the following environment variables:

LELU_ENGINE_URL=https://your-lelu-engine.example.com

LELU_API_KEY=your_secure_api_key_here

5Configure Lelu Client

Initialize the Lelu client in your application to start authorizing agent actions:

import { LeluClient } from "@lelu-auth/lelu";

export const lelu = new LeluClient({
  baseUrl: process.env.LELU_ENGINE_URL!,
  apiKey: process.env.LELU_API_KEY!,
});

// Example: Authorize an agent action
const decision = await lelu.agentAuthorize({
  actor: "support_agent",
  action: "issue_refund",
  context: { confidence: 0.85 }
});

if (decision.requiresHumanReview) {
  console.log("Action queued for human approval");
} else if (decision.allowed) {
  console.log("Action approved autonomously");
}

from lelu import LeluClient
import os

lelu = LeluClient(
    base_url=os.environ["LELU_ENGINE_URL"],
    api_key=os.environ["LELU_API_KEY"]
)

# Example: Authorize an agent action
decision = lelu.agent_authorize(
    actor="support_agent",
    action="issue_refund",
    confidence=0.85
)

if decision.requires_human_review:
    print("Action queued for human approval")
elif decision.allowed:
    print("Action approved autonomously")

✓That's it!