Thanks to visit codestin.com
Credit goes to github.com

Skip to content

vindicara-inc/projectair

Repository files navigation

Project AIR

Evidence-grade infrastructure for accountable AI agents.
Cryptographic chain-of-custody. Court-supportable records. Rekor-anchored proof.

vindicara.io · Quickstart · Pricing · Verify our ops chain · Blog

Python 3.12+ MIT PyPI


What AIR is

AIR writes a Signed Intent Capsule for every agent decision. Each capsule carries a BLAKE3 content hash and an Ed25519 signature (with opt-in experimental ML-DSA-65 / FIPS 204 post-quantum signing), chained to the previous step. The chain root is anchored to Sigstore Rekor (public transparency log) and RFC 3161 trusted timestamps. The result is evidence that survives subpoena, survives the vendor, and survives the auditor's first question.

pip install projectair
air demo

The four-layer stack

Layer What it does Status
0. Detection 10 of 10 OWASP Agentic + 3 OWASP LLM + 1 AIR-native (14 detectors) shipped
1. External Trust Anchor RFC 3161 timestamps + Sigstore Rekor transparency log shipped (0.4.0)
2. Causal Reasoning air explain walks the chain, explains why a step happened shipped (0.5.0)
3. Containment + Step-Up Halt agent actions; require Auth0-verified human approval shipped (0.6.0)
4. AgDR Handoff Protocol (A2A) Cross-agent chain of custody with W3C Trace Context shipped (0.7.0, Wave 1 alpha)

We run it on our own infrastructure

Vindicara dogfoods Project AIR. Every API request to vindicara.io is recorded as a signed AgDR chain using the same airsdk library customers use, anchored to public Sigstore Rekor every 60 seconds, and published as redacted JSONL.

Verify it yourself:

curl https://vindicara-ops-chain-public-399827112476.s3.us-west-2.amazonaws.com/ops-chain/manifest.json

The chain catalog, manifest, and every Rekor anchor are independently verifiable with zero Vindicara infrastructure in the path. See vindicara.io/ops-chain for the live dashboard.

Detector coverage

OWASP Top 10 for Agentic Applications (10 of 10): ASI01 Agent Goal Hijack, ASI02 Tool Misuse, ASI03 Identity & Privilege Abuse (Zero-Trust AgentRegistry), ASI04 Agentic Supply Chain (partial, MCP), ASI05 Unexpected Code Execution, ASI06 Memory & Context Poisoning, ASI07 Insecure Inter-Agent Communication, ASI08 Cascading Failures, ASI09 Human-Agent Trust Exploitation, ASI10 Rogue Agents (Zero-Trust BehavioralScope).

OWASP Top 10 for LLM Applications (3 categories): LLM01 Prompt Injection, LLM04 Model DoS, LLM06 Sensitive Data Exposure.

AIR-native (1): AIR-04 Untraceable Action (forensic-chain-integrity check).

Total: 14 detectors running over every chain, mapped to public taxonomies.

Framework integrations

Framework Integration Since
LangChain AIRCallbackHandler 0.1.0
OpenAI SDK instrument_openai 0.1.0
Anthropic SDK instrument_anthropic 0.1.0
LlamaIndex instrument_llamaindex 0.3.1
Google Gemini SDK instrument_gemini 0.3.2
Google ADK instrument_adk 0.3.2
NVIDIA NIM / vLLM / TGI / Together / Groq / Mistral / Fireworks via instrument_openai (OpenAI-compatible) 0.3.2
Custom code AIRRecorder directly 0.1.0

What's in this repo

This is a monorepo.

  • packages/projectair/: the MIT-licensed projectair package on PyPI. Ships the air CLI and the airsdk Python library. This is the public product.
  • site/: the SvelteKit source for vindicara.io.
  • src/vindicara/: the Apache-2.0 engine substrate (policy evaluator, MCP scanner, agent IAM, drift monitor, compliance collector, ops chain). Powers AIR Cloud.
  • packages/air-dashboard/: the AIR Cloud dashboard (SvelteKit + Three.js).

CLI surface

air demo                  Cold-start demo (SSH-exfil attack chain, 14 detectors)
air trace <chain>         Verify signatures, run detectors, emit forensic report
air verify-public <chain> Verify using only public infrastructure (no Vindicara calls)
air anchor <chain>        Anchor the chain to RFC 3161 + Sigstore Rekor
air explain <chain>       Causal explanation: --step <id> | --finding <detector_id>
air approve               Layer 3 step-up: --token | --device | --authorize-url
air handoff verify        Layer 4: eight-step cross-agent chain-of-custody verifier
air report article72      EU AI Act Article 72 post-market monitoring template

License

  • packages/projectair/ and the projectair PyPI distribution: MIT. See packages/projectair/LICENSE.
  • src/vindicara/ (engine substrate): Apache-2.0.

About

Project AIR: forensic reconstruction and incident response for AI agents. Signed AgDR decision records, OWASP ASI01-ASI10 detection, signed forensic evidence exports.

Topics

Resources

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors