Your first governed agent.
In 5 minutes.

MAREF is a pure Python package. Zero native dependencies, zero GPU required. It installs on any modern Python 3.11+ environment — macOS, Linux, Windows, or container.

pip install maref

That's it. One command. ~2 MB download.

Run the built-in diagnosis to verify your environment is ready. It checks Python version, detects your OS, tests SM4-GCM cryptography, and confirms all subsystems report healthy.

maref diagnose

Expect green ✅ across all checks. If something's missing, the diagnosis tells you exactly what to fix.

The demo starts a local web UI where you can watch governance decisions happen in real time. No configuration needed — it runs with sensible defaults and a toy agent so you can see every layer working before you connect your own agents.

maref demo --port 8080

Open http://localhost:8080 in your browser. The dashboard shows the 8-layer defense pipeline, trust scores, and audit log — all live.

See exactly how MAREF is protecting your system — which defense layers are active, current trust scores, and recent governance decisions.

maref status

The output shows each defense layer's state, recent BLOCK/ALLOW decisions, and the current Lyapunov convergence indicator.