Maida documentation

Catch agent changes before merge.#

Record how an agent runs, compare it with a reviewed baseline, and block structural regressions inside CI.

60 second quickstart local | no keys 
uv tool install "maida-ai==0.6.1"
maida demo --regression
MAIN PR agent lookup search x3 CRM new answer answer
Start with a task
First run Protect one coding-agent task See a regression, capture one real task, and review a few checks. CI gate Gate a pull request Capture a reviewed baseline and fail CI when behavior regresses. Instrument Python tool-calling agents Add Maida to a Python entrypoint with a small, framework-neutral SDK. Adapters Connect your framework Check the supported capture integrations and their coverage. Evidence Inspect a run Follow the tool path, timing, loops, warnings, and errors locally.

Find the exact interface#

CLI reference

Every command, option, output shape, and exit code.

SDK reference

Tracing contexts and event recorders for Python agents.

Policy v2

Define acceptable structural behavior as code.

Trace format

The versioned OTel-compatible data contract.

External emitter guide

Produce native Maida traces without the Python SDK.

Configuration

Environment variables, YAML precedence, and safe local storage.