Documentation

Welcome to the Admina documentation. Admina is an open source governance framework (Apache 2.0) for AI agents and LLM systems. It provides governed AI development through an SDK, transparent proxy, plugin system, CLI, and real-time dashboard.

⚡
Quick Start
Governance in 5 minutes. Clone, run docker compose, done.
→
🏛️
4 Governance Domains
Data Sovereignty, AI Infrastructure, Agent Security, Compliance.
→
📊
Admina Score
Live-runtime governance composite (0–100). Formula, components, how to improve.
→
🛡️
OISG Adequacy
Open · Intelligent · Secure · Governed — Admina's default paradigm.
→
🔌
Integrations
OpenClaw, LangChain, CrewAI, n8n, Cheshire Cat AI.
→
📡
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, domain tuning, deployment modes.
→

What is Admina?

Admina is an open framework for governed AI development. It works as both an SDK (in-process GovernedModel, GovernedData, GovernedAgent, ComplianceKit) and a transparent proxy (network). Every AI interaction is automatically governed: PII redacted, injections blocked, loops broken, actions audited, and EU AI Act compliance tracked.

Key properties:

  • OISG adequate by default — Open · Intelligent · Secure · Governed, scored automatically from live runtime state
  • Bidirectional — both requests and responses are governed
  • Dual mode — SDK (in-process) and proxy (network)
  • Hybrid runtime — Rust core (~6µs median) with automatic Python fallback
  • Plugin system — 9 interfaces, 14 built-in implementations
  • 5 framework integrations — OpenClaw, LangChain, CrewAI, n8n, Cheshire Cat
  • 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 covering 4 governance domains: 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)