whatisgithub

What is adtech-eval-lab?

davidspiegs/adtech-eval-lab — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 4/5Setup · hard

In one sentence

A small test suite that checks how well AI agents can handle realistic, messy digital advertising operations work.

Mindmap

mindmap
  root((AdTech Eval Lab))
    What it does
      Tests AI agents on ad ops tasks
      Uses synthetic billing data
      Scores with deterministic checks
    Tech stack
      Python
      Harbor
      Docker
    Use cases
      Revenue reconciliation task
      Campaign discrepancy investigation
      Model comparison
    Audience
      AI researchers
      Ad ops professionals
      Eval designers

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

Test how well an AI agent can reconcile ad revenue data across multiple messy sources.

USE CASE 2

Evaluate an AI agent's ability to investigate an advertiser billing discrepancy.

USE CASE 3

Study how to design realistic, deterministic evaluation tasks for AI agents.

USE CASE 4

Compare different AI models on long, multi-step professional workflows.

What is it built with?

PythonHarborDocker

How does it compare?

davidspiegs/adtech-eval-lab0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyhardmoderatehard
Complexity4/54/51/5
Audienceresearcherdeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Harbor and Docker installed, plus agent credentials to run model-backed tests.

So what is it?

This project builds a small test suite for checking how well AI agents handle the messy, real world work of digital advertising operations, often called Ad Ops. The author noticed that while there is a lot of AI research on general office tasks, almost nothing exists that tests AI on the specific kind of work done by people who manage online ad campaigns, so they built two realistic tasks based on their own experience working at ad technology companies. The two tasks ask an AI agent to reconcile billing numbers between an ad server and a supply platform, read PDF invoices, match up inconsistently named campaigns and advertisers, apply specific business rules, and produce a finished Excel report. One task is modeled on a monthly finance close where revenue numbers need to be checked and audited. The other is modeled on investigating a complaint from an advertiser about missing ad impressions or other campaign problems. Both tasks are checked automatically using a set of deterministic pass or fail rules built into the project, so results do not depend on human judgment. The author tested a handful of AI models on these tasks with a limited number of trials, since the project was built on a personal budget. One model passed every trial on both tasks, another model did well but occasionally slipped on one specific calculation step, and a third, cheaper model struggled more, especially with picking the right metrics and handling time zones correctly. The author is upfront that this is a small, synthetic dataset meant to explore how to design fair AI evaluation tasks, not a large scale industry benchmark. The project uses the Harbor framework for structuring and running these evaluation tasks, along with Docker to run each task in its own environment. It includes the test data, the correct reference solutions, the automated checking scripts, and written reports explaining what the author learned while designing the tasks. All the data used is synthetic and made up, based on the author's own industry knowledge, and contains no real company or customer information.

Copy-paste prompts

Prompt 1
Help me set up Harbor and Docker to run the oracle solution for the revenue reconciliation task in this repo.
Prompt 2
Explain how the deterministic verifier checks the Excel audit report in this eval suite.
Prompt 3
Show me how to run a model-backed agent against the campaign discrepancy investigation task.
Prompt 4
Help me design a new synthetic ad ops evaluation task modeled on this project's structure.

Frequently asked questions

What is adtech-eval-lab?

A small test suite that checks how well AI agents can handle realistic, messy digital advertising operations work.

What language is adtech-eval-lab written in?

Mainly Python. The stack also includes Python, Harbor, Docker.

How hard is adtech-eval-lab to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is adtech-eval-lab for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.