explaingit

nienhq/papertrail-bench

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 3/5LicenseSetup · easy

TLDR

An early-stage benchmark that tests whether an AI can find and cite the right facts in a simulated company's years of business email.

Mindmap

mindmap
  root((PaperTrail-Bench))
    What it does
      Retrieval benchmark
      Citation correctness scoring
    Tech stack
      Python
    Use cases
      Benchmark AI retrieval
      Test citation accuracy
      Study time sensitive facts
    Audience
      AI researchers
    Status
      Early B0 stage
      Generator working
      Harness not built yet

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Benchmark an AI retrieval system's ability to find facts across years of business email.

USE CASE 2

Test whether an AI correctly cites the exact source message for a claim.

USE CASE 3

Generate a synthetic company's email archive with known, checkable ground truth.

USE CASE 4

Study how well retrieval systems handle amendment chains and time-sensitive facts.

What is it built with?

Python

How does it compare?

nienhq/papertrail-bench0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity3/52/54/5
Audienceresearchergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Only the corpus generator works today, the evaluation harness that scores answers is not built yet.

In plain English

PaperTrail-Bench is a benchmark for testing whether an AI system can correctly find and cite old records buried in years of business email, similar to how a bookkeeper would look things up. It is built around a simulated company's multi year email and attachment archive, with questions that have a single provably correct answer and an exact source citation. The project argues that no existing benchmark really covers this kind of task. Other benchmarks either test memory of a chat conversation or test reading a small set of formal financial documents, but nothing tests searching through messy, redundant, real world style business correspondence spanning years. The way it works is that the correct facts and their timeline are written first, as a structured record of business events, including things like amendments and changes over time. The email archive that a system actually searches through is then generated from that structured record, deliberately made messy and repetitive the way real email is. Every benchmark question is computed directly from that structured record, so there is always a checkable right answer along with the exact spans of text that justify it. Questions are split into separate categories that are scored independently, covering things like looking up a specific record, tracing a chain of amendments to a document, asking what was true as of a certain date, combining information across several email threads, telling apart similarly named entities, correctly saying no matching record exists, and citing the exact right source. The project is at an early stage: the tool that generates the fake company data and the format for the correct answers already work, but only three of the seven planned question categories are built, and the part of the project that actually scores an AI system's answers does not exist yet. It requires Python 3.12 or newer and has no other software dependencies to run. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me generate a synthetic PaperTrail-Bench corpus with a fixed random seed.
Prompt 2
Explain how PaperTrail-Bench's ground-truth-first generation approach works.
Prompt 3
Show me the current question categories in PaperTrail-Bench and which ones are still planned.
Prompt 4
Walk me through running the generator and its test suite.

Frequently asked questions

What is papertrail-bench?

An early-stage benchmark that tests whether an AI can find and cite the right facts in a simulated company's years of business email.

What language is papertrail-bench written in?

Mainly Python. The stack also includes Python.

How hard is papertrail-bench to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is papertrail-bench for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.