Heads up This site is currently under heavy development.
← all tools
◆ AI/LLM Security

Adrian

python-sdk-v1.2.0 open-source

Open-source runtime AI agent security tool - monitors and controls AI agents, catching malicious tool use, prompt injection, and policy drift in real time, before the agent acts.

Summary

Adrian is an open-source runtime security layer for AI agents, free to use under an Apache-2.0 licence, that watches an agent's actions and reasoning as it runs and can alert, block, or route decisions to a human reviewer before they execute. It ships as an SDK you wrap around existing code (a few lines around a LangChain or Anthropic-based agent, or a Claude Code plugin via hooks) with events streamed to a hosted or self-hosted dashboard, making it a fit for teams building or securing agentic AI systems rather than traditional application security teams. The README frames it as a runtime counterpart to static analysis and network monitoring, catching prompt-injection and out-of-remit behaviour those miss, and includes PII redaction for agent transcripts. Development is active, with recent releases adding reasoning capture across SDKs and deeper Claude Code integration.

Open-source runtime AI agent security tool - monitors and controls AI agents, catching malicious tool use, prompt injection, and policy drift in real time, before the agent acts.

What Adrian answers

Which agent frameworks does it actually work with today?

LangChain and LangGraph agents, Anthropic SDK agents, and Claude Code via a hooks-based plugin, with reasoning capture across both the Python and TypeScript SDKs

Does blocking an action mean waiting on a person?

not necessarily - an agent profile is set to alert without stopping anything, block automatically against policy, or hold for a human to approve on the dashboard, and this can be chosen per agent

What happens to sensitive data that passes through an agent's conversation?

transcripts can be filtered for categories like email, phone, SSN, credit card, and passport numbers before they're stored, redacting them rather than logging them raw

Do I need to run my own infrastructure to use it?

no - events stream to a hosted dashboard by default, though the same SDK can point at a self-hosted backend instead

Will this slow down or change how my agent runs?

it wraps existing code with a couple of lines and captures calls as they happen, but the streaming transport requires the agent to run on an async event loop rather than making calls synchronously

What do I see for an action that gets flagged?

the event feed shows the classification verdict and a severity code, alongside the agent's reasoning trace where the model exposes one, not just the action it took

all 6 features, with the evidence for each →

Features

6 capabilities

Built from everything we hold on Adrian — every release we have summarised, its product documentation and how that documentation has changed, its README, its command-line surface and API, and runs we performed ourselves. Dates are when we first saw a capability, not when the vendor introduced it.

Capability area
All capabilities 6 capabilities
Claude Code integration shipped Connects Claude Code hooks to the Adrian backend via WebSocket, parsing transcripts and enforcing allow/deny/advisory verdicts in three server-driven modes: alert, block, and human-in-the-loop. 4 releases · first seen Aug 2026

release

  • Adds Claude Code plugin (integrations/claude-code/adrian_cc/agent.py) that connects Claude Code hooks to the Adrian backend via WebSocket, supporting three server-driven execution modes: MODE_ALERT (fire-and-forget), MODE_BLOCK (wait for verdict, block per policy), and MODE_HITL (wait for human approval on the… python-sdk-v1.1.0 · Aug 2026 · source · release history
  • New Claude Code plugin (integrations/claude-code/adrian_cc/agent.py) connects Claude Code hooks directly to the Adrian backend via WebSocket, sending SessionLogin + PairedEvent protobuf messages and returning allow/deny/advisory verdicts. commits-2026-07-09 · Aug 2026 · source · release history
  • Adds a transcript parser (integrations/claude-code/adrian_cc/transcript.py) that reads Claude Code's JSONL transcript to extract thinking blocks, user prompts, system prompt context, and invocation metadata, with mtime-based caching to avoid re-parsing on every hook call. commits-2026-07-09 · Aug 2026 · source · release history
  • Supports three server-driven execution modes read from PolicySnapshot on LoginAck: MODE_ALERT (fire-and-forget, never blocks), MODE_BLOCK (waits for verdict, blocks per policy), and MODE_HITL (waits for human approval on the dashboard). commits-2026-07-09 · Aug 2026 · source · release history
Human-in-the-loop (HITL) verdict forwarding shipped Forwards human approval decisions made on the Adrian dashboard back inline to connected Claude Code integrations. 2 releases · first seen Aug 2026

release

  • Forwards HITL verdicts from the Adrian backend to Claude Code for native inline approval workflows. python-sdk-v1.1.0 · Aug 2026 · source · release history
  • Adds HITL verdict forwarding: human approval decisions made on the Adrian dashboard are now forwarded inline to Claude Code integrations tagged with the CC source. commits-2026-07-09 · Aug 2026 · source · release history
PII filtering shipped Detects and redacts PII across 12 categories — including email, SSN, credit card, IBAN, passport, and AWS keys — from agent conversations before they are transmitted. 2 releases · first seen Aug 2026

release

  • Adds PII filtering for the Claude Code plugin (adrian_cc/pii/_patterns.py), detecting 12 PII categories: EMAIL, PHONE, SSN, CREDIT_CARD, IP_ADDRESS, DATE_OF_BIRTH, IBAN, PASSPORT, STREET_ADDRESS, POSTAL_CODE, DRIVER_LICENSE, and AWS_KEY. python-sdk-v1.1.0 · Aug 2026 · source · release history
  • Adds PII filtering for the Claude Code plugin (integrations/claude-code/adrian_cc/pii/_patterns.py), detecting and redacting EMAIL, PHONE, SSN, CREDIT_CARD, IP_ADDRESS, DATE_OF_BIRTH, IBAN, PASSPORT, STREET_ADDRESS, POSTAL_CODE, DRIVER_LICENSE, and AWS_KEY categories from agent conversation… commits-2026-07-09 · Aug 2026 · source · release history
Anthropic SDK instrumentation shipped Instruments agents built with the Anthropic Python SDK to send events to the Adrian backend. 1 release · first seen Aug 2026

release

  • Adds Anthropic SDK integration, enabling Adrian instrumentation for agents built with the Anthropic Python SDK. python-sdk-v1.1.0 · Aug 2026 · source · release history
Event severity classification shipped Assigns severity badges to events based on MAD codes and surfaces the latest verdict metadata in the event list. 1 release · first seen Aug 2026

release

  • Adds severity badges to the Events table and mobile cards based on MAD codes, with latest verdict metadata now included in the event list API response. python-sdk-v1.1.0 · Aug 2026 · source · release history
LangChain and LangGraph instrumentation shipped Instruments agents built with LangChain and LangGraph to send events to the Adrian backend. 1 release · first seen Aug 2026

release

  • Extracts LangChain/LangGraph instrumentation into langchain_handler.py, consolidating that integration surface. python-sdk-v1.1.0 · Aug 2026 · source · release history
Capability
Evidence

Lines in monospace are the tool's own words — help text parsed from its source, or an endpoint from its API document. Everything else is our summary of a dated release or documentation change, linked back to the source it came from.

Release history

  1. python-sdk-v1.2.0 Aug 18, 2026 · issue 005

    Adrian Python SDK v1.2.0 adds reasoning capture for LangChain and OpenAI-compatible models, including a new reasoning field in LLM events.

    └──▷ GET THIS VERSION
    $ git clone --branch python-sdk-v1.2.0 https://github.com/secureagentics/Adrian.git
    # already have the repo? check out this version:
    $ git checkout python-sdk-v1.2.0
    • Adds a reasoning field to LLM end events in the Python SDK, populated via _extract_reasoning() from LangChain ChatGeneration messages, capturing chain-of-thought output from reasoning models.
    • Extends reasoning capture to support three provider layouts: a summary list of {type: 'summary_text', text: ...} entries (OpenAI Responses / LangChain default), a bare reasoning string (LangChain output_version='v1'), and Anthropic's thinking string.
    • Adds reasoning capture to the TypeScript OpenAI SDK integration, reading delta.reasoning_content from streamed chat completion chunks for OpenAI-compatible servers that surface chain-of-thought in that field.
  2. python-sdk-v1.1.0 Aug 11, 2026 · issue 005

    Adrian Python SDK v1.1.0 adds a Claude Code plugin with HITL verdicts, PII filtering, and Anthropic SDK integration.

    └──▷ GET THIS VERSION
    $ git clone --branch python-sdk-v1.1.0 https://github.com/secureagentics/Adrian.git
    # already have the repo? check out this version:
    $ git checkout python-sdk-v1.1.0
    Screenshot 2026-06-10 at 2 27 02 AM
    • New Claude Code plugin (integrations/claude-code/adrian_cc/agent.py) connects Claude Code hooks to the Adrian backend via WebSocket, supporting three server-driven execution modes: MODE_ALERT (fire-and-forget), MODE_BLOCK (wait for verdict, block on policy), and MODE_HITL (wait for human approval on the dashboard).
    • Adds PII filtering to the Claude Code plugin (integrations/claude-code/adrian_cc/pii/_patterns.py), detecting 12 PII categories — EMAIL, PHONE, SSN, CREDIT_CARD, IP_ADDRESS, DATE_OF_BIRTH, IBAN, PASSPORT, STREET_ADDRESS, POSTAL_CODE, DRIVER_LICENSE, and AWS_KEY — in agent conversations before they are forwarded.
    • HITL verdicts are now forwarded to Claude Code for native inline approval, enabling human-in-the-loop decisions to flow directly back to a running Claude Code session.
    • Adds Anthropic SDK integration, allowing Adrian to instrument Anthropic API calls alongside the existing LangChain/LangGraph support.
    • LangChain/LangGraph instrumentation is extracted into langchain_handler.py, isolating the handler for cleaner integration management.
    +1 moreshow less
    • Severity badges now appear in the Events table and mobile cards, based on MAD codes, and the event list API response adds latest verdict metadata while omitting full payload and token fields from list rows.
my-toolchain — 0 tools
paste an install list to detect your tools

A brew list, a Brewfile, requirements.txt, a Dockerfile — or just the product names, free-form. Nothing leaves your browser.

    browse all tools →