Skip to content
@airblackbox

AIR Blackbox

The flight recorder for autonomous AI agents — record, replay, enforce, audit

AIR Blackbox
Open-source compliance infrastructure for AI agents

Tamper-proof audit trails · PII tokenization · Policy enforcement · AI Bill of Materials


What is AIR Blackbox?

AIR Blackbox is the compliance layer between your AI agents and production. It records every LLM call, tool invocation, and agent decision into tamper-evident audit chains — so you can prove what your AI did, when, and why.

Built for teams shipping AI agents that need to meet EU AI Act requirements by August 2026.

Architecture

Your Agent Code
       │
       ▼
┌──────────────────┐
│   AIR Gateway    │  ← reverse proxy, records every LLM call
│   (Go binary)    │
└────────┬─────────┘
         │
    ┌────┴─────┬──────────────┬─────────────────┐
    ▼          ▼              ▼                 ▼
 Audit     PII            Policy           AI Bill of
 Chain     Tokenization   Engine           Materials
 (HMAC)    (DataVault)    (risk tiers)     (CycloneDX)
    │          │              │                 │
    └────┬─────┴──────────────┴─────────────────┘
         ▼
   Compliance Report
   (Articles 9–15)

Get Started

pip install air-blackbox

Framework trust layers (drop-in, no code changes):

pip install air-langchain-trust     # LangChain / LangGraph
pip install air-crewai-trust        # CrewAI
pip install air-openai-trust        # OpenAI Agents SDK
pip install air-anthropic-trust     # Claude Agent SDK
pip install air-adk-trust           # Google ADK
pip install air-rag-trust           # RAG pipelines

MCP server (Claude Desktop, Claude Code, Cursor):

pip install air-blackbox-mcp

Full stack (Gateway + Episode Store + Policy Engine + Jaeger):

git clone https://github.com/airblackbox/air-platform
cd air-platform && make up

Repositories

Core

Repo What it does
gateway AI governance control plane — CLI scanner, reverse proxy, audit trails
air-platform Full stack Docker Compose deployment (Gateway + Episode Store + Policy Engine + Jaeger)
air-gate AI action firewall — HMAC-SHA256 audit chain with tool gating and PII redaction
air-blackbox-mcp MCP server — 14 compliance tools for Claude Desktop, Claude Code, and Cursor
compliance-action GitHub Action — EU AI Act compliance checks on every PR

Framework Trust Layers

Repo Framework
air-langchain-trust LangChain / LangGraph
trust-crewai CrewAI
air-adk-trust Google Agent Development Kit
air-rag-trust RAG pipelines

Observability & Safety

Repo What it does
otel-collector-genai OTel Collector processor — PII redaction, cost metrics, loop detection
otel-prompt-vault Encrypted prompt/completion storage with pre-signed URL retrieval
otel-semantic-normalizer Normalizes gen_ai.* attributes to standard schema
runtime-aibom-emitter AI Bill of Materials from runtime OTel traces (CycloneDX)
aibom-policy-engine Policy-as-code for AI supply chain governance
mcp-security-scanner Security scanner for MCP server configurations
mcp-policy-gateway Policy enforcement gateway for Model Context Protocol

Evaluation & Testing

Repo What it does
eval-harness Replay and score agent episodes against policies
trace-regression-harness Detect behavioral regressions across agent versions

PyPI Packages

Package Version Install
air-blackbox 1.8.0 pip install air-blackbox
air-gate 0.2.0 pip install air-gate
air-blackbox-mcp 0.2.0 pip install air-blackbox-mcp
air-blackbox-sdk 0.1.1 pip install air-blackbox-sdk
air-compliance 1.0.0 pip install air-compliance
air-langchain-trust 0.2.0 pip install air-langchain-trust
air-crewai-trust 0.1.0 pip install air-crewai-trust
air-openai-trust 0.1.0 pip install air-openai-trust
air-anthropic-trust 0.1.0 pip install air-anthropic-trust
air-adk-trust 0.2.0 pip install air-adk-trust
air-rag-trust 0.1.0 pip install air-rag-trust

Links


EU AI Act enforcement begins August 2, 2026. Start now.

Pinned Loading

  1. gateway gateway Public

    AI governance control plane — EU AI Act compliance, AI-BOM, shadow AI detection, and tamper-proof audit trails. pip install air-blackbox

    Python 13 2

  2. air-platform air-platform Public

    Full-stack AIR Blackbox deployment — Gateway + Episode Store + Policy Engine + Jaeger (Docker Compose)

    Python 9

  3. air-blackbox-mcp air-blackbox-mcp Public

    MCP server for EU AI Act compliance scanning — scan, analyze, and remediate Python AI agents

    Python 1 1

Repositories

Showing 10 of 26 repositories
  • airblackbox/airblackbox-site’s past year of commit activity
    HTML 0 0 0 0 Updated Apr 7, 2026
  • air-gate Public

    HMAC-SHA256 audit chain engine with human-in-the-loop tool gating (EU AI Act Article 12)

    airblackbox/air-gate’s past year of commit activity
    Python 1 Apache-2.0 0 1 0 Updated Apr 6, 2026
  • gateway Public

    AI governance control plane — EU AI Act compliance, AI-BOM, shadow AI detection, and tamper-proof audit trails. pip install air-blackbox

    airblackbox/gateway’s past year of commit activity
    Python 13 Apache-2.0 2 8 (8 issues need help) 0 Updated Apr 6, 2026
  • air-trust Public

    Universal compliance trust layer for AI systems. One install, any framework. Local-first HMAC-SHA256 audit chain. EU AI Act ready.

    airblackbox/air-trust’s past year of commit activity
    Python 0 Apache-2.0 0 0 0 Updated Apr 6, 2026
  • .github Public

    Organization profile and community health files

    airblackbox/.github’s past year of commit activity
    0 0 0 0 Updated Apr 4, 2026
  • air-controls-mcp Public

    MCP server for AIR Controls — runtime visibility for AI agents in Cursor, Claude Code, Windsurf

    airblackbox/air-controls-mcp’s past year of commit activity
    Python 0 0 0 0 Updated Apr 3, 2026
  • air-controls Public

    See what your AI agents actually do. Runtime visibility for LangChain, CrewAI, AutoGen, and custom agents.

    airblackbox/air-controls’s past year of commit activity
    Python 0 Apache-2.0 0 0 0 Updated Apr 3, 2026
  • air-blackbox-mcp Public

    MCP server for EU AI Act compliance scanning — scan, analyze, and remediate Python AI agents

    airblackbox/air-blackbox-mcp’s past year of commit activity
    Python 1 Apache-2.0 1 1 0 Updated Apr 2, 2026
  • air-platform Public

    Full-stack AIR Blackbox deployment — Gateway + Episode Store + Policy Engine + Jaeger (Docker Compose)

    airblackbox/air-platform’s past year of commit activity
    Python 9 Apache-2.0 0 3 (3 issues need help) 0 Updated Apr 2, 2026
  • Roo-Code Public Forked from RooCodeInc/Roo-Code

    Roo Code gives you a whole dev team of AI agents in your code editor.

    airblackbox/Roo-Code’s past year of commit activity
    TypeScript 0 Apache-2.0 2,990 0 0 Updated Mar 29, 2026

Top languages

Loading…

Most used topics

Loading…