Quickstart

Compliance for your AI agents in 5 minutes.

One pip install, four commands, 89% automated. No Docker, no config, nothing leaves your machine.

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 · optional

Start the full gateway

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 · discover · replay · export

comply

EU AI Act compliance from live gateway traffic. Checks across Articles 9–15.

discover

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

replay

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

export

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

December 2027.
EU AI Act high-risk enforcement deadline (pushed back from August 2026). Penalties up to €35M or 7% of global turnover. Get compliant before they come asking.
View on GitHub →