garrytan/gbrain-evals

No description

HTML186 ★LLM & Prompt ToolingGitHub ↗
Quality: solid 17/24
PAI: integrate 0.5
Appraised: 2026-05-27 current
Contents

Overview

Verdict

Rating Summary
Quality solid (17/24) Actively committed, well-documented benchmark suite with strong adoption signals, let down only by no formal releases and HTML as the GitHub-reported primary language
PAI Relevance integrate (0.50) BrainBench's sealed-qrels enforcement, planted-perturbation corpus design, and multi-adapter harness pattern offer concrete methodology to extract for PAI's Evals skill

Composite is exactly at the 0.50 INTEGRATE threshold; the practical integration action is methodology study and pattern extraction rather than running gbrain-evals as-is against PAI, since all adapters call into gbrain/* subpath exports and would need full replacement.

Quality Assessment

17/24 — maintained / adequately-documented / solid

Health: 5/8 (maintained)

Failed:

Passed:

Documentation: 6/8 (adequately-documented)

Failed:

Passed:

Engineering Signals: 6/8 (solid)

Failed:

Passed:

PAI Relevance

Dimension Score Assessment
Harvest Value 1 The sealed-qrels enforcement pattern (gold _facts metadata that never crosses the adapter boundary), planted-perturbation corpus design (10 contradictions, 5 stale facts, 5 paraphrased-injection poison items), and 12-category BrainBench structure each offer concrete techniques worth extracting for PAI's Evals skill, which currently handles general agent evaluation rather than retrieval-quality benchmarking specifically.
Integration Readiness 1 All runner scripts are TypeScript and Bun-native (stack match), but every adapter imports from gbrain/* subpath exports; adapting the harness to PAI's Knowledge subsystem requires replacing the adapter layer — moderate glue, not drop-in.
Overlap Risk 1 Partial overlap with PAI's existing Evals skill (AI agent evaluation); gbrain-evals focuses specifically on retrieval-quality metrics (P@5, R@5, per-type F1, latency p95), a narrower sub-domain the Evals skill does not deeply cover.
Gap Fill 1 PAI has no dedicated retrieval-quality benchmark harness for its Knowledge subsystem; gbrain-evals addresses that functional gap but requires adaptation away from gbrain internals before it can measure PAI's retrieval pipeline.

Composite: 0.50

What Next

Landscape Position

Category: LLM & Prompt Tooling

In this category: mattpocock--evalite (decent, 15/24)

Standing: gbrain-evals scores higher than evalite on every dimension and addresses a more specific domain — personal knowledge agent retrieval benchmarking with committed corpora — versus evalite's general LLM output evaluation; both lack formal releases.

Evidence Base

Density: 7/10 — Available: full README, complete package.json, repo metadata (stars, forks, dates, license, open issues, archived flag), dependency manifest, scripts catalog, benchmark results table. Missing: actual TypeScript source files, CI configuration, CHANGELOG, contributor graph, test output examples.

Notes

The HTML-as-primary-language tag is misleading — it reflects committed benchmark report files rather than the TypeScript evaluation codebase; actual runner and adapter code is entirely .ts. The version string "v0.40.6.0" in results tracks the parent garrytan/gbrain release, not a gbrain-evals release tag. The claimed SOTA LongMemEval _s result (97.60% R@5) compares against MemPalace's published 96.6% rather than a fresh same-environment re-run of MemPalace, which is a methodology caveat worth noting when reading the cross-system comparison table.