# AIR Blackbox

EU AI Act compliance for your AI agents in 5 minutes

pip install air-blackbox 4 commands 89% automated

## Quickstart

STEP 1

### Install

    pip install air-blackbox

STEP 2

### Run the demo

Generates sample AI agent records and runs a compliance check. No Docker, no config.

    air-blackbox demo

→ Creates 10 sample .air.json records (4 models, 3 providers)
→ Generates RISK_ASSESSMENT.md + DATA_GOVERNANCE.md templates
→ Runs EU AI Act compliance check: Articles 9-15

STEP 3

### See your compliance status

    air-blackbox comply -v

Shows per-article status with detection type (AUTO/HYBRID/MANUAL) and fix hints for every failing check.

STEP 4

### Discover what's in your environment

    air-blackbox discover

Shows every model, provider, and API endpoint your agents are using. Shadow AI detection built in.

STEP 5

### Start the full gateway (optional)

For live traffic analysis with HMAC audit chains, tamper-proof logging, and real-time compliance:

    git clone https://github.com/airblackbox/airblackbox.git
    cd gateway
    cp .env.example .env   # add your OPENAI_API_KEY
    docker compose up

Then point your LLM client at the gateway:

    from openai import OpenAI
    from air_blackbox import AirBlackbox

    air = AirBlackbox()
    client = air.wrap(OpenAI())
    # Every LLM call is now HMAC-logged through the gateway

## The Four Commands

### comply

EU AI Act compliance from live gateway traffic. 18 checks across Articles 9-15.

### discover

Shadow AI inventory + AI-BOM generation. Every model, tool, and provider cataloged.

### replay

Incident reconstruction from tamper-proof audit chain. Full agent timeline.

### export

Signed evidence bundles for auditors and insurers. One command, one document.

## August 2, 2026

EU AI Act high-risk enforcement deadline.
Penalties up to €35M or 7% of global turnover.

Get compliant before they come asking.

View on GitHub →