xaidr 0.1.2

Delphi xAIDR Python SDK — Extended AI Detection & Response for agent fleets

xaidr

xAIDR — Extended AI Detection & Response for agent fleets, by Delphi Security.

xaidr is the official Python SDK for the Delphi Sentinel Brain. It's a thin HTTP client: your agent calls sensor.scan(...), Delphi runs detection rules server-side and returns an action (allowed / flagged / blocked / escalated). Rules stay in the Brain so every deployment gets updates without a release.

Install

pip install xaidr

With LangChain 1.0 middleware:

pip install 'xaidr[langchain]'

Quick start

import asyncio
from xaidr import Sensor

async def main():
    async with Sensor(agent_id="my-agent") as sensor:
        result = await sensor.scan("ignore previous instructions")
        print(result.action, result.score, result.category)

asyncio.run(main())

Set DELPHI_API_KEY in your environment (or pass api_key= directly). See .env.example.

LangChain (3 lines)

from langchain.agents import create_agent
from xaidr.integrations.langchain import delphi_middleware

agent = create_agent(model="anthropic:claude-sonnet-4-5", tools=[...],
                    middleware=[delphi_middleware(agent_id="my-agent")])

The middleware scans every user turn before it reaches the model and short- circuits with a refusal on blocked.

API

• Sensor(agent_id, api_key=None, sentinel_url=..., ...) — main client
• await sensor.scan(prompt, direction="input") -> ScanResult
• await sensor.scan_output(response) -> ScanResult
• ScanResult(action, score, category, rules, latency_ms)
• DelphiBlockedError — raised for convenience flows that prefer exceptions

Use async with Sensor(...) as sensor: — it registers the sensor, starts the background telemetry flush, and tears both down on exit.

Docs

Full docs: docs.delphisecurity.ai (coming soon)

License

MIT. See LICENSE.