aigp-server — AIGP Governance Engine

Reference governance server for the AIGP Runtime Governance Protocol (AIGP) v4.0. Provider-based architecture with jurisdictional AI governance.

Install

pip install aigp-server

What It Does

The governance server evaluates AI requests against 5 jurisdictional rule engines in strict priority order:

IHL (RFC-027) → EU AI Act (RFC-028) → AU Strategy (RFC-029) → Japan Act (RFC-030) → Universal (RFC-031)

First DENY wins. 35 governance rules total.

Quick Start

from aigp_server import GovernanceEngine, AigpRouter, ServerConfig

# Configure
config = ServerConfig(
    storage={"provider": "memory"},       # or "dynamodb"
    mode="REPORT",                        # REPORT (fail-open) or ENFORCE (fail-closed)
)
components = config.build()

# Create engine + router
engine = GovernanceEngine(components.store, components.scope_mgr, components.circuit_breaker, mode="REPORT")
router = AigpRouter(engine, hmac_secret="your-secret")

# Declare jurisdictional context
await engine.declare_universal_context("my-app", {"active": True, "principles": "ALL"})

# Handle requests (framework-agnostic — returns (status_code, response_dict))
status, resp = await router.handle_tool_request(headers, body)

Jurisdictional Governance (v4.0)

Each has a corresponding GET endpoint: /api/v1/{context}/{app_id}

Rule Engines

Provider Architecture

aigp_server/
├── governance_engine.py     Core engine — 5-layer evaluation
├── routes.py                Framework-agnostic HTTP handlers
├── ihl_rules.py             RFC-027
├── euai_rules.py            RFC-028
├── au_rules.py              RFC-029
├── jp_rules.py              RFC-030
├── universal_rules.py       RFC-031
├── hmac_auth.py             HMAC-SHA256 request signing
├── config.py                Provider configuration
├── providers/
│   ├── storage/             memory, dynamodb
│   ├── scope/               ScopeEnvelopeManager, CircuitBreakerService
│   ├── enforcement/         bedrock, azure, gcp adapters
│   ├── pii/                 regex, presidio, comprehend
│   ├── key_store/           local, kms, vault
│   └── consent/             Tier-aware tokenization

Agentic Governance Handlers

Implementing Your Own

This is a reference implementation. To build your own governance server:

1. pip install aigp-server for the engine + rules
2. Wire AigpRouter handlers into your HTTP framework (FastAPI, Flask, Express, etc.)
3. Implement StorageProviderBase for your database
4. Deploy behind your own infrastructure

The aigp-client SDK (all 8 languages) talks to any server implementing the AIGP HTTP contract.

License

Proprietary — © 2025-2026 Kanjani AI Research & Causum. All rights reserved.