Skip to content

Add top-level README and publish H100 benchmark reports - #3

Open
abhay1999 wants to merge 2 commits into
agentgateway:mainfrom
abhay1999:readme-and-reports
Open

Add top-level README and publish H100 benchmark reports#3
abhay1999 wants to merge 2 commits into
agentgateway:mainfrom
abhay1999:readme-and-reports

Conversation

@abhay1999

@abhay1999 abhay1999 commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

What this is

Two tasks for this repo while we wait on management's decision on funding the full benchmarking campaign:

  1. Top-level README - the repo had just a one-line stub pointing at inference/README.md. Replaced it with a real explanation of what the repo is, its layout, a quick-start command, and a summary of the current published results.

  2. Reports from agentgateway/agentgateway#2526 - brought over the actual published campaign (optimized-baseline-v0230-gateway-refresh-20260817, 16x H100 GPUs, both comparisons: service-vs-agentgateway-standalone and service-vs-agentgateway-gateway) with its campaign manifest, provenance, metrics, and charts. Verified this is the exact same file set as in #2526 by diffing against gh pr view 2526 --json files.

Also updated inference/reports/README.md's placeholder text ("reports will be added separately") since reports are now actually here.

Next up

Once this PR merges, next is an agentgateway/website PR adding benchmark report subpages under /docs/standalone/latest/inference/ and /docs/kubernetes/latest/inference/, followed by #2 (making router/EPP resource requests configurable for local Kind testing).

Adds a real top-level README explaining what this repo is, its
layout, and a quick-start command, replacing the placeholder stub.

Also brings over the published benchmark reports from
agentgateway/agentgateway#2526 - the real 16x H100 GPU campaign
comparing agentgateway standalone and agentgateway-on-Kubernetes
against a plain Kubernetes Service, with campaign manifest,
provenance, metrics, and charts for both comparisons.

Signed-off-by: abhay1999 <abhaychaurasiya19@gmail.com>
Comment on lines +78 to +79
- [k8s service (RR) native results](../../../../../results/llm-d-benchmark/optimized-baseline-v0230-gateway-refresh-20260817/runs/service)
- [agentgateway on Kubernetes native results](../../../../../results/llm-d-benchmark/optimized-baseline-v0230-gateway-refresh-20260817/runs/agentgateway-gateway)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These two links are broken.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed, they pointed into the gitignored results/ tree.

Comment on lines +78 to +79
- [k8s service (RR) native results](../../../../../results/llm-d-benchmark/optimized-baseline-v0230-gateway-refresh-20260817/runs/service)
- [agentgateway standalone native results](../../../../../results/llm-d-benchmark/optimized-baseline-v0230-gateway-refresh-20260817/runs/agentgateway-standalone)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These 2 links are broken.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed, same issue.

Comment thread README.md
Comment on lines +23 to +26
```bash
make kind-create
BENCHMARK_TREATMENT=service BENCHMARK_CAMPAIGN_ID=local-sim make benchmark
```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a note about the system requirements with a reference to #2.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added, linking #2.

Comment thread README.md
BENCHMARK_TREATMENT=service BENCHMARK_CAMPAIGN_ID=local-sim make benchmark
```

See [`inference/README.md`](inference/README.md) for the full set of treatments,

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove the following from inference/README.md:

PR #1 intentionally migrates tooling only. Curated reports from the original agentgateway repository change are not part of this migration and will be published separately with their supporting evidence.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed.

- Removed the "native results" links in both comparison READMEs.
  They pointed into the gitignored results/ tree, which was never
  committed, per review.
- Added a note in the root README pointing out that agentgateway-
  standalone/-gateway currently need more resources than a laptop
  Kind cluster provides, linking agentgateway#2.
- Removed the now-stale "reports will be published separately" line
  from inference/README.md, since this PR publishes them.

Signed-off-by: abhay1999 <abhaychaurasiya19@gmail.com>

@danehans danehans left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for resolving my review feedback. @howardjohn I plan on creating an agentgateway/website PR to publish these results to to the inference routing docs, PTAL.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants