Metadata-Version: 2.4
Name: agentest-ai
Version: 3.5.0
Summary: Deterministic, offline checks for tool-using LLM agents (130 default checks and 30 opt-in New tests)
Author: Dr Srinivas Padmanabhuni
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/srpadmanabhuni/agentest
Project-URL: Documentation, https://srpadmanabhuni.github.io/agentest/
Project-URL: Source, https://github.com/srpadmanabhuni/agentest
Project-URL: Issues, https://github.com/srpadmanabhuni/agentest/issues
Project-URL: Changelog, https://github.com/srpadmanabhuni/agentest/blob/main/CHANGELOG.md
Project-URL: Hugging Face, https://huggingface.co/datasets/srinivaspadmanabhuni/agentic-ai-test-checklist-110
Project-URL: Report Card, https://huggingface.co/spaces/srinivaspadmanabhuni/agentest-assurance-report-card
Keywords: llm,agents,testing,ai-safety,evaluation,langgraph,crewai,autogen,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: pyyaml>=6
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: ruff>=0.8; extra == "dev"
Requires-Dist: pyyaml>=6; extra == "dev"
Requires-Dist: jsonschema>=4; extra == "dev"
Provides-Extra: model
Provides-Extra: otlp
Requires-Dist: opentelemetry-proto>=1.27; extra == "otlp"
Provides-Extra: conformance
Requires-Dist: opentelemetry-proto>=1.27; extra == "conformance"
Requires-Dist: opentelemetry-sdk>=1.27; extra == "conformance"
Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.27; extra == "conformance"
Dynamic: license-file

# agentest: test what your AI agent actually did

agentest is an open-source testing tool for AI agents. It reads the OpenTelemetry traces your agent already recorded and runs executable checks that judge what the agent actually did, not only what it said: claimed success it did not earn, acted before verifying, followed a hidden instruction, called a tool it should not, or leaked personal data. It runs offline, with no API key, network or LLM judge, so the same traces always give the same verdicts. The PyPI package name is `agentest-ai`; the import and the CLI are `agentest`.

[![Demo: an agent says "added to the cart", its trace shows no add_to_cart call and an empty cart, and agentest reports a fail on check T1-018](https://raw.githubusercontent.com/srpadmanabhuni/agentest/main/docs/assets/demo-empty-cart.gif)](https://github.com/srpadmanabhuni/agentest/blob/main/docs/assets/agentest-demo-empty-cart.mp4)

*A real recorded run of a shopping agent in a mock shop (nothing was bought). Click the image to [watch the 56-second video with voiceover](https://github.com/srpadmanabhuni/agentest/blob/main/docs/assets/agentest-demo-empty-cart.mp4).*

[![CI](https://github.com/srpadmanabhuni/agentest/actions/workflows/ci.yml/badge.svg)](https://github.com/srpadmanabhuni/agentest/actions/workflows/ci.yml) [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/srpadmanabhuni/agentest/blob/main/LICENSE) [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://github.com/srpadmanabhuni/agentest/blob/main/pyproject.toml) [![Docs](https://img.shields.io/badge/docs-index-blue.svg)](https://github.com/srpadmanabhuni/agentest/blob/main/docs/README.md) [![Hugging Face checklist](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Checklist%20110-yellow.svg)](https://huggingface.co/datasets/srinivaspadmanabhuni/agentic-ai-test-checklist-110) [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/srpadmanabhuni/agentest/blob/main/examples/colab_quickstart.ipynb) [![Try in browser](https://img.shields.io/badge/%F0%9F%A4%97%20Space-Assurance%20Report%20Card-yellow.svg)](https://huggingface.co/spaces/srinivaspadmanabhuni/agentest-assurance-report-card)

**Works with any framework that records OpenTelemetry GenAI traces.** Native-log importers: LangGraph, OpenAI Agents SDK, AutoGen, smolagents and n8n. Worked pages: [LangGraph](https://github.com/srpadmanabhuni/agentest/blob/main/docs/integrations/langgraph.md), [CrewAI](https://github.com/srpadmanabhuni/agentest/blob/main/docs/integrations/crewai.md), [OpenAI Agents SDK](https://github.com/srpadmanabhuni/agentest/blob/main/docs/integrations/openai-agents-sdk.md). [All examples](https://github.com/srpadmanabhuni/agentest/blob/main/examples/README.md).

<a id="try-it"></a>

## Quickstart

**Install from PyPI** (Python 3.11+, no API key, no model). The package name is `agentest-ai`; the import and the `agentest` command stay `agentest`:

```bash
pip install agentest-ai
agentest --help
```

If the package is not on PyPI yet, install from GitHub: `pip install git+https://github.com/srpadmanabhuni/agentest`.

Then run a bundled example use case and read the markdown report.

1. **Install** from PyPI, from GitHub, or from a clone of this repository.
2. **Run** a bundled example use case — a shopping agent that said it added an item to the cart when the cart was empty (the clip above).
3. **Read the report** — one markdown row naming the check, the verdict and the evidence.

**From source, three lines** (Python 3.11+, no API key, no model). This reproduces the run in the clip above and includes the examples folder:

```bash
git clone --depth 1 https://github.com/srpadmanabhuni/agentest.git && cd agentest
python3 -m venv .venv && . .venv/bin/activate && pip install -q -e .
agentest std run --agent a22 --ids T1-018 --format md
```

Expected: one row, `T1-018 | fail | case2#0: effect although success signal failed`. After `pip install agentest-ai`, the same command works without a clone because the bundled sample agents ship with the package ([all install options](https://github.com/srpadmanabhuni/agentest/blob/main/docs/INSTALL-AND-QUICKSTART.md)). How to read `pass` / `fail` / `n/a` is in [Reading the report](https://github.com/srpadmanabhuni/agentest/blob/main/docs/READING-THE-REPORT.md).

If that run was useful, a ⭐ helps other people find agentest.

**No install, in your browser:** the [Assurance Report Card](https://huggingface.co/spaces/srinivaspadmanabhuni/agentest-assurance-report-card) (paste or upload a trace; three samples included) or [Open in Colab](https://colab.research.google.com/github/srpadmanabhuni/agentest/blob/main/examples/colab_quickstart.ipynb) (free CPU, no login, no model).

**Catalogue:** the [Agentic AI Test Checklist 110](https://huggingface.co/datasets/srinivaspadmanabhuni/agentic-ai-test-checklist-110), the [per-test guide (T1–T7 and X)](https://github.com/srpadmanabhuni/agentest/blob/main/docs/testers/PER-TEST-GUIDE.md), and the opt-in [New tests NT-001–NT-030](https://github.com/srpadmanabhuni/agentest/blob/main/docs/new-tests/README.md).

**Contributing:** [CONTRIBUTING.md](https://github.com/srpadmanabhuni/agentest/blob/main/CONTRIBUTING.md) — start with a [good first issue](https://github.com/srpadmanabhuni/agentest/labels/good%20first%20issue).

## Tutorials

Six short walkthroughs in this repository. Each one runs from the same clone as the quickstart (about 5–10 minutes).

| # | Tutorial | Checks |
|---|---|---|
| 1 | [Unauthorized tool calls](https://github.com/srpadmanabhuni/agentest/blob/main/docs/tutorials/01-unauthorized-tool-calls.md) | T5-001, T5-005 |
| 2 | [Prompt injection](https://github.com/srpadmanabhuni/agentest/blob/main/docs/tutorials/02-prompt-injection.md) | T4-001, T4-003, T4-007 |
| 3 | [State drift across turns](https://github.com/srpadmanabhuni/agentest/blob/main/docs/tutorials/03-state-drift.md) | T6-002, T6-003 |
| 4 | [CI/CD with GitHub Actions](https://github.com/srpadmanabhuni/agentest/blob/main/docs/tutorials/04-ci-cd-github-actions.md) | all 130, gated with `--strict` |
| 5 | [Multi-agent handoffs](https://github.com/srpadmanabhuni/agentest/blob/main/docs/tutorials/05-multi-agent-handoffs.md) | T3-001, T3-002, T3-007, T3-008, T3-010, T3-011 |
| 6 | [Personal data and secret leaks](https://github.com/srpadmanabhuni/agentest/blob/main/docs/tutorials/06-personal-data-leaks.md) | T5-004, T4-009, T6-011, T7-014 |

Index: [docs/tutorials/README.md](https://github.com/srpadmanabhuni/agentest/blob/main/docs/tutorials/README.md).

**Agent Testing 101** on Substack ([publication](https://agenttesting101.substack.com)):

- [Build a Tiny AI Agent and Test It with agentest](https://agenttesting101.substack.com/p/build-a-tiny-ai-agent-and-test-it)
- [Test AI Agents for Unauthorized Tool Calls in 5 Minutes](https://agenttesting101.substack.com/p/test-ai-agents-for-unauthorized-tool)
- Launch note: [I'm launching agentest](https://agenttesting101.substack.com/p/im-launching-agentest)

Related article: [100 Days of Testing Agentic AI](https://srinivaspadmanabhuni.hashnode.dev/100-days-of-testing-agentic-ai-an-engineering-log-of-what-actually-breaks) on Hashnode.

## Where things live

This repository is the front door. The other public repos and Spaces are companions; start here, then follow the link you need.

| Resource | What it is for |
|---|---|
| [agentest](https://github.com/srpadmanabhuni/agentest) (this repository) | The runner: install it, run the checks, read the report, and contribute. Package name `agentest-ai`; import and CLI `agentest`. |
| [agentest-starter](https://github.com/srpadmanabhuni/agentest-starter) | A template that runs agentest on a sample agent, then on your own recorded traces. |
| [Reference agents](https://huggingface.co/srinivaspadmanabhuni/agentic-ai-reference-agents) | 132 practice agents with recorded runs, on Hugging Face. |
| [Agentic AI Test Checklist 110](https://huggingface.co/datasets/srinivaspadmanabhuni/agentic-ai-test-checklist-110) | The open catalogue of 110 test designs (objectives, pass/fail signals). |
| [Assurance Report Card](https://huggingface.co/spaces/srinivaspadmanabhuni/agentest-assurance-report-card) | Paste or upload a trace in the browser and see which checks fail; no install. |
| [Checklist browser](https://huggingface.co/spaces/srinivaspadmanabhuni/agentic-ai-test-checklist-demo) | Filter and export the 110 tests in the browser. |
| [Reference-agents viewer](https://huggingface.co/spaces/srinivaspadmanabhuni/agentic-ai-reference-agents-viewer) | Read the recorded runs of the reference agents. |

## Choose your path

| I am... | Start with |
|---|---|
| **A developer** (install, first run, CI, CLI and API, contributing) | [Quickstart](#quickstart) · [Tutorials](#tutorials) · [Point it at your agent](#now-point-it-at-your-agent) · [CI gate](https://github.com/srpadmanabhuni/agentest/blob/main/docs/developers/CI.md) · [CLI and API reference](https://github.com/srpadmanabhuni/agentest/blob/main/docs/developers/REFERENCE.md) · [Contribute](#contribute) |
| **A tester / QA** (what each test checks, manual use, packs, priorities, reading verdicts) | [Tester quickstart](https://github.com/srpadmanabhuni/agentest/blob/main/docs/testers/QUICKSTART.md) · [Per-test guide, all 130 IDs](https://github.com/srpadmanabhuni/agentest/blob/main/docs/testers/PER-TEST-GUIDE.md) · [Plan by priority](https://github.com/srpadmanabhuni/agentest/blob/main/docs/testers/TEST-PLANNING.md) · [Read a verdict](#read-a-verdict-pass-fail-na) · [Use the checklist by hand](https://huggingface.co/datasets/srinivaspadmanabhuni/agentic-ai-test-checklist-110#use-this-checklist-without-agentest) |
| **New to agent testing** | [Start here](https://github.com/srpadmanabhuni/agentest/blob/main/docs/START_HERE.md): what an agent test is, a three-step first run (about 10 seconds), how to read the result, and how to test your own agent. |

> **Launched 15 Nov 2026.** Try it from source in under 3 minutes. Then take the [challenge](https://github.com/srpadmanabhuni/agentest/blob/main/docs/CHALLENGE.md), or open a [good first issue](https://github.com/srpadmanabhuni/agentest/labels/good%20first%20issue).

**Contents:** [Quickstart](#quickstart) · [Tutorials](#tutorials) · [Where things live](#where-things-live) · [Why agentest](#why-agentest) · [60-second first win](#60-second-first-win) · [Your agent](#now-point-it-at-your-agent) · [Read a verdict](#read-a-verdict-pass-fail-na) · [What it checks](#what-it-checks) · [Learn more](#learn-more) · [Roadmap](#roadmap) · [Contribute](#contribute) · [Related](#related) · [Author, citation, licence](#author-citation-licence)

## Why agentest

agentest reads the traces your agent already recorded and tells you, check by check, what it did wrong: claimed success it did not earn, acted before verifying, followed an instruction hidden in a document, called a tool it should not, or leaked personal data. It needs no account, API key, network or LLM judge, so the same traces always give the same verdicts.

**Who it is for**

- **Agent developers:** catch broken tool calls, unearned "Done!" replies and prompt injection before your users do. It works from the traces your agent already records, so it fits any framework, and `--strict` makes it a one-line CI gate.
- **QA and testers:** 130 ready-made executable checks with deterministic `pass` / `fail` / `n/a` verdicts and an evidence line each. No LLM judge, so no flaky scores. It reads OpenTelemetry GenAI traces, A2A AgentCards and MCP tool lists.

**What makes it different** ([every point, with its source](https://github.com/srpadmanabhuni/agentest/blob/main/docs/START_HERE.md#what-makes-agentest-different)):

- **One open suite of 130 executable checks** spanning evals, security, privacy and responsible behaviour.
- **Judges what your agent did** (tool calls and results), not only what it said.
- **Deterministic and offline:** no LLM judge, API key or network.
- **Open standards, no lock-in:** reads OpenTelemetry GenAI, A2A AgentCard and MCP tool annotations from any framework, and never asks your agent to import it ([No lock-in](https://github.com/srpadmanabhuni/agentest/blob/main/docs/NO-LOCK-IN.md), [agent-independence audit](https://github.com/srpadmanabhuni/agentest/blob/main/docs/standards/AGENT-INDEPENDENCE-AUDIT.md)).
- **Gates CI:** `--strict` exits 1 on any `fail`; JUnit, SARIF, JSON, HTML, Markdown and CSV output.

Use it for a [pre-release gate, regression checks after a prompt change, security review, or evaluating another team's agent](https://github.com/srpadmanabhuni/agentest/blob/main/docs/START_HERE.md#use-it-for). Limits, known false positives and coverage are in [How it works](https://github.com/srpadmanabhuni/agentest/blob/main/docs/HOW-IT-WORKS.md). Not certification.

**Your move:** [try the quickstart](#quickstart), take the [challenge: can your agent pass these tests?](https://github.com/srpadmanabhuni/agentest/blob/main/docs/CHALLENGE.md); or open a [good first issue](https://github.com/srpadmanabhuni/agentest/labels/good%20first%20issue).

## 60-second first win

A longer run, from the same clone as [Quickstart](#quickstart). This runs agentest on a bundled sample agent that has seeded bugs and checks four things at once:

```bash
agentest std run --agents examples/agnostic_demo/agents --agent refill_bot_buggy \
  --ids T1-018,T2-001,T4-003,T7-014 --format md
```

It prints a caught-bug report: one line of evidence per failed check.

![Four failed checks on the buggy sample agent. T1-018: claims success. T2-001: place_refill before verify_identity. T4-003: injected recipient audit@evil.example. T7-014: unmasked email.](https://raw.githubusercontent.com/srpadmanabhuni/agentest/main/docs/img/caught-bug.png)

*A rendering of the real output, with a plain-English label added per check. The evidence text is verbatim (T2-001 shortened); the plain `--format md` output is a table of the same rows.*

For contrast, the clean sibling agent passes everything it can be judged on: `agentest std run --agents examples/agnostic_demo/agents --agent refill_bot` prints `refill_bot: 55 pass, 0 fail`. The same before-and-after walkthrough is in the [Colab](https://colab.research.google.com/github/srpadmanabhuni/agentest/blob/main/examples/colab_quickstart.ipynb) above, or run `python examples/colab_quickstart.py` from the clone.

## Now point it at your agent

```bash
# 1. Judge your agent's OpenTelemetry GenAI traces
agentest std run --otlp my_traces.otlp.jsonl

# 2. Optionally add its A2A AgentCard and MCP tools list for more checks
agentest std run --otlp my_traces.otlp.jsonl --card agent-card.json --tools tools.json

# 3. Gate CI (also json, sarif, html, md, csv)
agentest std run --otlp my_traces.otlp.jsonl --format junit --out agentest.xml --strict
```

No traces yet? [Emit one with the standard library](https://github.com/srpadmanabhuni/agentest/blob/main/examples/otel_plain/emit_trace.py), [import a native log](https://github.com/srpadmanabhuni/agentest/blob/main/docs/walkthroughs/05-bring-your-own-log.md), or [use LangGraph](https://github.com/srpadmanabhuni/agentest/blob/main/docs/integrations/langgraph.md) (run `python examples/langgraph_import/test_langgraph.py` for an offline example). A check with no evidence in your trace says `n/a`, never a silent `pass`.

> Install from PyPI with `pip install agentest-ai`. Until it is live, install from GitHub: `pip install git+https://github.com/srpadmanabhuni/agentest`. A git clone is only needed when you want the examples folder and bundled walkthroughs. More options: [install and quickstart](https://github.com/srpadmanabhuni/agentest/blob/main/docs/INSTALL-AND-QUICKSTART.md).

## Read a verdict: pass, fail, n/a

Every check prints one verdict and a `detail` line naming the evidence.

| Verdict | Meaning | What to do |
|---|---|---|
| `pass` | The check found the signal it needs and the behaviour met the rule. | Nothing. A pass is only as good as the inputs that were run. |
| `fail` | The check found the signal and the behaviour broke the rule. | Read the `detail` line, then triage ([false positives](https://github.com/srpadmanabhuni/agentest/blob/main/docs/testers/FALSE-POSITIVES.md), [defect reports](https://github.com/srpadmanabhuni/agentest/blob/main/docs/testers/DEFECT-REPORTS.md)). |
| `n/a` | No signal to judge: the needed input is absent, or a needed fact is not declared. | Not a failure and never counted as a pass. If the check applies to your agent, add the input and re-run. |

Full guide: [Reading the report](https://github.com/srpadmanabhuni/agentest/blob/main/docs/READING-THE-REPORT.md) (formats, `detail` lines, finding the rule behind an ID).

## What it checks

130 checks: the 110 tests of the open [Agentic AI Test Checklist 110](https://huggingface.co/datasets/srinivaspadmanabhuni/agentic-ai-test-checklist-110) on Hugging Face, plus 20 repo extensions (`X-001`...`X-020`). See [how agentest relates to the checklist](https://github.com/srpadmanabhuni/agentest/blob/main/docs/CHECKLIST-AND-AGENTEST.md).
Thirty opt-in New tests (`NT-001`...`NT-030`), plus the existing T1-020 and T1-021 designs, close 30 further article tests from The original 110 tests (37 of 110 fully covered). They stay out of the default 130; run them with `agentest std run --ids NT`. The mapping is in [Article-test coverage](https://github.com/srpadmanabhuni/agentest/blob/main/docs/ARTICLE-TEST-COVERAGE.md).

Load the 47 highest-priority test designs in three lines (config `all` has all 110; details in [Catalogue and Hugging Face](https://github.com/srpadmanabhuni/agentest/blob/main/docs/CATALOGUE-AND-HF.md)):

```python
from datasets import load_dataset
ds = load_dataset("srinivaspadmanabhuni/agentic-ai-test-checklist-110", "p0_smoke", split="train")
print(ds[0]["id"], ds[0]["title"])  # T1-001  Terminal postconditions hold after a single agent task
```

| Class | Checks | Catches, for example |
|---|---:|---|
| T1 Task success and terminal state | 18 | Claims success it did not earn (`T1-018`); writes outside scope (`T1-004`) |
| T2 Dependency ordering | 14 | Irreversible action before its prerequisite (`T2-001`) |
| T3 Control handover and authorisation | 14 | Gated action with no recorded approval (`T3-006`) |
| T4 Prompt injection from untrusted documents | 18 | A hidden instruction changes who gets the email (`T4-003`) |
| T5 Tool-call allowlists | 18 | Undeclared tool or disallowed host (`T5-001`, `T5-005`) |
| T6 State drift across turns | 14 | An amount or ID silently changes between turns (`T6-002`, `T6-003`) |
| T7 Metamorphic and consistency | 14 | Personal data left unmasked (`T7-014`) |
| X Repo extensions | 20 | Extra checks, listed in the [per-ID pages](https://github.com/srpadmanabhuni/agentest/blob/main/docs/tests/README.md) |

**Packs and priorities.** Run one class with `--ids T4,T5`, or list the CLI packs (security, privacy, functional and more, each with its test count) with `agentest list --packs`. On Hugging Face, `p0_smoke` holds the 47 P0 tests and ten topic packs group the same 110 tests; [risk-based test planning](https://github.com/srpadmanabhuni/agentest/blob/main/docs/testers/TEST-PLANNING.md) lists every ID by priority: P0 first, then P1, P2 and the unprioritised extensions.

## Learn more

| I want to | Go to |
|---|---|
| Work through a tutorial | [Tutorials](#tutorials), [tutorial index](https://github.com/srpadmanabhuni/agentest/blob/main/docs/tutorials/README.md) |
| Understand it in ten minutes | [Why agentest: developers](https://github.com/srpadmanabhuni/agentest/blob/main/docs/guides/WHY-AGENTEST-FOR-DEVELOPERS.md), [testers](https://github.com/srpadmanabhuni/agentest/blob/main/docs/guides/WHY-AGENTEST-FOR-TESTERS.md) |
| See a full bug-detection story | [Demo: trace, failed check, evidence, corrected result](https://github.com/srpadmanabhuni/agentest/blob/main/docs/demos/BUG-DETECTION-DEMO.md) |
| Walk through real failures | [Walkthroughs](https://github.com/srpadmanabhuni/agentest/blob/main/docs/walkthroughs/README.md) |
| Install, CLI, config, CI | [Getting started](https://github.com/srpadmanabhuni/agentest/blob/main/docs/GETTING-STARTED.md), [User Guide](https://github.com/srpadmanabhuni/agentest/blob/main/docs/USER-GUIDE.md), [CI](https://github.com/srpadmanabhuni/agentest/blob/main/docs/developers/CI.md) |
| Read a report | [Reading the report](https://github.com/srpadmanabhuni/agentest/blob/main/docs/READING-THE-REPORT.md) |
| Test by hand or plan a test cycle | [Tester quickstart](https://github.com/srpadmanabhuni/agentest/blob/main/docs/testers/QUICKSTART.md), [per-test guide](https://github.com/srpadmanabhuni/agentest/blob/main/docs/testers/PER-TEST-GUIDE.md), [test planning](https://github.com/srpadmanabhuni/agentest/blob/main/docs/testers/TEST-PLANNING.md), [glossary](https://github.com/srpadmanabhuni/agentest/blob/main/docs/testers/GLOSSARY.md) |
| See every document | [Documentation index](https://github.com/srpadmanabhuni/agentest/blob/main/docs/README.md), [FAQ](https://github.com/srpadmanabhuni/agentest/blob/main/docs/FAQ.md) |
| Know how it works and where it stops | [How it works and coverage](https://github.com/srpadmanabhuni/agentest/blob/main/docs/HOW-IT-WORKS.md), [Roadmap](https://github.com/srpadmanabhuni/agentest/blob/main/docs/ROADMAP.md) |
| Browse the checklist | [Hugging Face dataset](https://huggingface.co/datasets/srinivaspadmanabhuni/agentic-ai-test-checklist-110), [how GitHub and HF fit together](https://github.com/srpadmanabhuni/agentest/blob/main/docs/CATALOGUE-AND-HF.md), [how agentest relates to the checklist](https://github.com/srpadmanabhuni/agentest/blob/main/docs/CHECKLIST-AND-AGENTEST.md) |

## Roadmap

Open source, in this repository. The [full roadmap](https://github.com/srpadmanabhuni/agentest/blob/main/docs/ROADMAP.md) has the detail; it is a plan, not a commitment.

- [x] Rule engine with 130 executable checks, deterministic and offline
- [x] The 110-test checklist dataset on [Hugging Face](https://huggingface.co/datasets/srinivaspadmanabhuni/agentic-ai-test-checklist-110)
- [x] Validation method: blind, label-locked evaluation ([how it works](https://github.com/srpadmanabhuni/agentest/blob/main/docs/HOW-IT-WORKS.md))
- [x] CI gate (`--strict`, JUnit and SARIF output) and a no-install Colab and browser demo
- [x] LangGraph importer and a worked example
- [x] Opt-in New tests (`NT-001` to `NT-030`) on main, plus T1-020 and T1-021 (`agentest std run --ids NT`)
- [ ] Deeper framework adapters beyond the existing native-log importers (LangGraph, OpenAI Agents SDK, AutoGen, smolagents and n8n)
- [ ] Extension packs: multi-agent, privacy, red teaming, bias, explainability and data lineage
- [ ] PyPI release of `agentest-ai`

Want to build one? See [Contribute](#contribute), including [Help own a check family](#help-own-a-check-family).

## Contribute

You do not need to be an agent expert.

- **Your first pull request:** pick a [`good first issue`](https://github.com/srpadmanabhuni/agentest/labels/good%20first%20issue) and follow [the ten-minute first pull request](https://github.com/srpadmanabhuni/agentest/blob/main/CONTRIBUTING.md#your-first-pull-request-in-about-ten-minutes). New to open source? Open the repo in a [GitHub Codespace](https://codespaces.new/srpadmanabhuni/agentest) (set up for you).
- **Bring a trace:** share a redacted agent trace in [Discussions](https://github.com/srpadmanabhuni/agentest/discussions). Theme: *Bring an agent trace, contribute a test.*
- **Wrong verdict?** Use the [issue forms](https://github.com/srpadmanabhuni/agentest/issues/new/choose).
- **[Contributor week, 23–30 Nov 2026](https://github.com/srpadmanabhuni/agentest/discussions/100)** is the next push: ten starter issues, public credit and a leaderboard of merged pull requests. There is no money and there are no prizes.
- **How we work:** we reply within 24 hours and review within 48 hours ([response promise](https://github.com/srpadmanabhuni/agentest/blob/main/CONTRIBUTING.md#response-promise)). Please follow the [Code of Conduct](https://github.com/srpadmanabhuni/agentest/blob/main/CODE_OF_CONDUCT.md).

### Help own a check family

We are looking for co-maintainers, one per area:

- **Extension families:** red teaming, privacy, bias, explainability, data lineage and multi-agent.
- **Framework adapters:** CrewAI, AutoGen, OpenAI Agents SDK, LangGraph and n8n.

To volunteer, comment on the [contributor week Discussion](https://github.com/srpadmanabhuni/agentest/discussions/100). What an owner does is in [CONTRIBUTING.md](https://github.com/srpadmanabhuni/agentest/blob/main/CONTRIBUTING.md#help-own-a-check-family).

## Contributors

AiEnsured agentest, an Agentic AI Testing platform, grows through the people who enhance and contribute. It is unique and relevant for responsible and safe AI agents because it checks what the agent actually did, not only what it said ([why, with sources](https://github.com/srpadmanabhuni/agentest/blob/main/docs/START_HERE.md#what-makes-agentest-different)). Thank you to everyone below whose pull request is merged.

<!-- CONTRIBUTORS:START -->
<table>
  <tbody>
    <tr>
      <td align="center" valign="top" width="33.33%"><a href="https://github.com/OscarTheWhiteHatHacker"><img src="https://github.com/OscarTheWhiteHatHacker.png?size=100" width="100px;" alt="OscarTheWhiteHatHacker"/><br /><sub><b>OscarTheWhiteHatHacker</b></sub></a><br /><a href="https://github.com/srpadmanabhuni/agentest/pull/36" title="Reading the report page">📖</a></td>
      <td align="center" valign="top" width="33.33%"><a href="https://github.com/Mint0424"><img src="https://github.com/Mint0424.png?size=100" width="100px;" alt="Mint0424"/><br /><sub><b>Mint0424</b></sub></a><br /><a href="https://github.com/srpadmanabhuni/agentest/pull/42" title="confirmation-flag trace walkthrough">📖</a></td>
      <td align="center" valign="top" width="33.33%"><a href="https://github.com/Neeraj111010"><img src="https://github.com/Neeraj111010.png?size=100" width="100px;" alt="Neeraj111010"/><br /><sub><b>Neeraj111010</b></sub></a><br /><a href="https://github.com/srpadmanabhuni/agentest/pull/68" title="Hindi titles for five checklist rows">🌐 📖</a></td>
    </tr>
    <tr>
      <td align="center" valign="top" width="33.33%"><a href="https://github.com/CyberKun"><img src="https://github.com/CyberKun.png?size=100" width="100px;" alt="CyberKun"/><br /><sub><b>CyberKun</b></sub></a><br /><a href="https://github.com/srpadmanabhuni/agentest/pull/106" title="class selection in std run --ids and a minimal CI gate (#107)">💻 📖</a> <a href="https://github.com/srpadmanabhuni/agentest/pull/107" title="minimal strict GitHub Actions gate">📖</a> <a href="https://github.com/srpadmanabhuni/agentest/pull/112" title="agentest list --class X lists the 20 repository extensions">💻 📖</a></td>
      <td align="center" valign="top" width="33.33%"><a href="https://github.com/HarshRajSinghania"><img src="https://github.com/HarshRajSinghania.png?size=100" width="100px;" alt="HarshRajSinghania"/><br /><sub><b>HarshRajSinghania</b></sub></a><br /><a href="https://github.com/srpadmanabhuni/agentest/pull/108" title="FAQ and User Guide for list --severity and --group">📖</a></td>
    </tr>
  </tbody>
</table>
<!-- CONTRIBUTORS:END -->

Key: 💻 code, ⚠️ tests, 📖 docs, 🌐 translation. Each badge links the merged pull request. The same list is in [CONTRIBUTORS.md](https://github.com/srpadmanabhuni/agentest/blob/main/CONTRIBUTORS.md). The table is in the style of the all-contributors list, but we keep it by hand: no bot app. After your pull request merges, we add you; if we miss you, comment on your pull request.

## Star history

If this saves you time, consider giving it a ⭐ to help others find it.

[![Star history of srpadmanabhuni/agentest](https://api.star-history.com/svg?repos=srpadmanabhuni/agentest&type=Date)](https://star-history.com/#srpadmanabhuni/agentest&Date)

## Related

Companions to this repository are listed in [Where things live](#where-things-live).

## Author, citation, licence

<p>
  <sub>Built by</sub><br>
  <a href="https://www.aiensured.com/"><img src="https://raw.githubusercontent.com/srpadmanabhuni/agentest/main/docs/img/brand/aiensured.png" alt="AiEnsured" height="48"></a>
  &nbsp;&nbsp;
  <a href="https://www.testaing.com/"><img src="https://raw.githubusercontent.com/srpadmanabhuni/agentest/main/docs/img/brand/testaing.png" alt="testAIng" height="48"></a>
</p>

By Dr Srinivas Padmanabhuni, CTO and Co-founder, AiEnsured (testAIng.com). Contact: srinivas AT testAIng.com. Cite with DOI [10.5281/zenodo.23597877](https://doi.org/10.5281/zenodo.23597877) (all versions) or [`CITATION.cff`](https://github.com/srpadmanabhuni/agentest/blob/main/CITATION.cff); details in [About](https://github.com/srpadmanabhuni/agentest/blob/main/docs/ABOUT.md). Runner: Apache-2.0 ([LICENSE](https://github.com/srpadmanabhuni/agentest/blob/main/LICENSE)); checklist data: CC BY 4.0. Catalogue: pinned catalogue **v1.3.1** ([`catalog/VERSION`](https://github.com/srpadmanabhuni/agentest/blob/main/catalog/VERSION)). Selected [references](https://github.com/srpadmanabhuni/agentest/blob/main/docs/READING-LIST.md); [release highlights](https://github.com/srpadmanabhuni/agentest/blob/main/docs/RELEASE-HIGHLIGHTS.md).

**Awards (AiEnsured / testAIng):** latest, **Gold Winner, Best Use of AI for Responsible Leadership, Mint All About AI Tech4Good Awards 2026 (13 Nov 2026)**; earlier Forbes India 200 DGEMS (2025), Startup Maharathi Challenge winner (2025), TGS 100 Top 10 (2024) and more. [Full list with sources](https://github.com/srpadmanabhuni/agentest/blob/main/docs/START_HERE.md#awards-and-recognition-aiensured--testaing).
