Documentation

Welcome to the Admina documentation. Admina is an open source governance proxy (Apache 2.0) for AI agents and LLM systems. It intercepts every interaction between agents and tools, applying 6 governance pillars bidirectionally.

⚡
Quick Start
Governance in 5 minutes. Clone, run docker compose, done.
→
🏛️
6 Governance Pillars
Loop Breaker, Firewall, PII, OTEL, Forensic, EU AI Act.
→
🦾
OpenClaw Integration
Skill for ClawHub, adapter and stdio bridge setup.
→
📡
API Reference
Full JSON-RPC 2.0 proxy API and REST endpoints.
→
⚙️
Rust Engine
Build admina_core, benchmarks, Python/Rust hybrid mode.
→
🔧
Configuration
Environment variables, pillar tuning, deployment modes.
→

What is Admina?

Admina is a transparent proxy that sits between AI agents and the tools they control (MCP servers, LLM APIs, databases, filesystems). Every request and response passes through all 6 governance pillars.

Key properties:

  • Bidirectional — both requests (agent → tool) and responses (tool → agent) are governed
  • MCP Native — speaks JSON-RPC 2.0, designed for Model Context Protocol
  • Hybrid runtime — Rust core (~14µs overhead) with automatic Python fallback
  • OpenClaw ready — skill for ClawHub, stdio bridge, adapter included
  • EU AI Act compliant — risk classification and gap analysis built in
  • Apache 2.0 — free to use, modify, and distribute forever

Architecture at a glance

Admina runs as a Docker Compose stack of 9 containers: proxy, dashboard, ClickHouse, MinIO, Redis, OpenTelemetry collector, Grafana, mock MCP server, and mock agent. 

# The full stack in one command
docker compose up --build

# Services started:
#  proxy      → :8080  (governance proxy + REST API)
#  dashboard  → :3000  (real-time governance UI)
#  otel       → :4317  (OpenTelemetry collector gRPC)
#  grafana    → :3001  (metrics and traces)
#  minio      → :9000  (forensic black box storage)

Enterprise features

Need more? DebugABot is built on Admina and adds ML-based injection detection, eIDAS-qualified forensics, SSO/RBAC, sycophancy detection, behavioral control, and managed cloud. See Enterprise for details.