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.5"
maida demo
maida view
maida demo --regression
MAIN PR agent lookup search ×3 CRM new answer answer
Start with a task
First run Try Maida in 60 seconds Run a deterministic agent and inspect its execution timeline. CI gate Gate a pull request Capture a reviewed baseline and fail CI when behavior regresses. Instrument Trace your agent Add Maida to a Python entrypoint with a small, framework-neutral SDK. Adapters Connect your framework Capture LangChain, LangGraph, OpenAI Agents, CrewAI, or Langfuse activity. 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.