IIO Framework Docs
Deterministische KI-Governance · EU AI Act konform · Apache 2.0
v1.0.0 Stable
Python 3.9+
EU AI Act Art. 4
Was ist IIO?
IIO (Intelligente Infrastruktur für Organisationen) ist ein deterministisches KI-Governance-Framework für mittelständische Unternehmen. Es stellt sicher dass KI-Systeme EU AI Act Art. 4 konform betrieben werden.
Kerneigenschaft: Kein LLM im Compliance-Pfad. Triage, Compliance-Checks und HITL-Gates laufen deterministisch — für gleiche Eingaben immer gleiche Ausgaben.
Quick Start (5 Minuten)
-
SDK installieren
pip install iio-governance
-
Workspace klonen
git clone https://github.com/zologitlab/iio-welcome cd iio-welcome export IIO_SPACE=$(pwd)
-
Erste Nutzung
iio status iio policy check iio gate list
-
Python SDK
from iio_governance import SmartTriage, TokenTracker triage = SmartTriage() result = triage.triage("Server down in production") print(result.routing_target) # "incident" print(result.priority) # "P2"
Architektur
IIO besteht aus 91 Governance-Layern, organisiert in einem deterministischen Layer-Graph:
| Layer-Gruppe | Beschreibung | Beispiele |
|---|---|---|
| Compliance | EU AI Act, GDPR, ISO 42001 | compliance_processor.py |
| Intake | Event-Ingestion + Triage | run-intake-pipeline.sh |
| HITL | Human-in-the-Loop Gates | hitl_decision_engine.py |
| Identity | 18 Identitäten L0-L4 | identity_engine.py |
| Billing | Token-Usage + Invoicing | billing_engine.py |
| Analytics | Matomo cookieless | matomo_adapter.py |
EU AI Act Setup
IIO setzt EU AI Act Art. 4 (AI Literacy) automatisch durch. Konfiguration:
from iio_governance.compliance import ComplianceCheck check = ComplianceCheck(workspace="/path/to/workspace") result = check.run() # result.eu_ai_act_art4 → True/False # result.gdpr_art5 → True/False
Verpflichtend seit 02.02.2025: Art. 4 gilt für alle Mitarbeiter die KI nutzen oder entwickeln — unabhängig von Unternehmensgröße.
HITL Gates
5 Gate-Level. Nur L4-Operatoren (zolo, anbe, todi) dürfen approven. Kein Agent-Approval.
from iio_governance.gate import HITLGate
gate = HITLGate("gate.deploy-production", level=3)
decision = gate.check_status()
if decision == "GO":
deploy()
elif decision == "PENDING":
print("Warte auf Operator-Freigabe")
Python SDK Module
| Modul | Import | Funktion |
|---|---|---|
| SmartTriage | iio_governance.triage | LLM-freie Event-Klassifikation |
| TokenTracker | iio_governance.billing | Token-Verbrauch + Kosten |
| IIOMCPClient | iio_governance.mcp_client | MCP Server Client |
| HITLGate | iio_governance.gate | HITL Gate Management |
| AuditTrail | iio_governance.audit | Audit-Log schreiben |
iio-cli Commands
iio status # Workspace-Status iio gate list # HITL-Gates anzeigen iio gate go <id> # GO-Request erstellen iio ai status # AI Hub status iio ai metrics <tenant> # Token-Usage iio intake list # Letzte Events iio intake run # Pipeline manuell starten iio policy check # Governance-Compliance iio identity list # Identitäten
MCP Server
127 Tools via Model Context Protocol (stdio, JSON-RPC 2.0).
# Claude Desktop config (~/.claude/config.json):
{
"mcpServers": {
"iio": {
"command": "python3",
"args": ["iio/base/mcp-server/iio-mcp-server.py"],
"env": {"IIO_SPACE": "/path/to/workspace"}
}
}
}