KUMA

KUMA Python SDK
Knowledge-grounded Universal Measurement for Agents

English  |  简体中文

KUMA is the public Python SDK for testing Agent behavior through a strict Run protocol and bounded Evidence capture. Official services are reached only through public HTTPS; the SDK does not run Agents, execute models, or expose private evaluation logic.

Core capabilities

• Synchronous, framework-neutral Case and Judge workflow.
• Official or custom Providers, including fully local runs.
• Bounded file, log, and optional trace Evidence.

Install

Python 3.10 or newer is required:

python -m pip install "kuma-defuzex==0.1.0"

Quick start

Run the deterministic local check without an account, API key, Docker, or network:

kuma quickstart

Full-stack user-flow example

Follow the full-stack user-flow guide to run KUMA with mini-SWE-agent in Docker. This path calls external services and may use service credit and model budget.

Detailed documentation

English SDK guide · Strategy Groups · Python API reference · 简体中文 SDK 指南 · 中文 API 参考 · Runtime Evidence contract

Project

Security · Contributing · Apache License 2.0