soev for developers
soev-evals

Overview

Evaluate agents, with evaluation contracts, scoring, judges and local run archives.

soev-evals runs the cases of an evaluation project against an agent, scores the answers with criteria and model judges, and archives each run on disk. It reaches the agent over HTTP, so it imports no other soev package. The command soev-evals runs, reports, rescores and seals a project. A model judge needs a runtime provider: see --runtime in the commands, or set runtime: in project.yaml. To seal a project is to record a digest of each test case, so that a later change to a sealed test case stops each command.

Install

soev-evals needs Python 3.12 or later.

pip install soev-evals
ExtraAdds
otelThe OpenTelemetry API and SDK, for soev_evals.track

Where to start

On this page