Deterministic — re-run in CI on every commit

Benchmarks you can re-run yourself

Every number on this page comes from one of two sources: a deterministic public benchmark on pinned, real OSS repos that CI re-runs on every commit, and community submissions PR'd into a schema-validated dataset. No synthetic demos, no cherry-picking — every row ships with the exact command that reproduces it.

40 of 40queries find their gold file on pinned real OSS repos
51–242×fewer tokens than pasting whole files
40pre-registered queries — every one reported
46–66×community-measured reduction on real repos, vs the CLI's fixed 50K-token estimate

The public benchmark

Cost and correctness, reported together

A token-reduction number with no correctness number attached is meaningless. The public benchmark scores both at once: does the objectively-correct file land in the context window, and how many tokens did it cost to put it there? Built to be hard to dismiss:

Real, pinned repos

Household-name OSS — requests, click, flask, rich — pinned to exact commit SHAs. Anyone can git checkout and audit; no vendor fixture.

Objective gold, no LLM judge

Each query's gold file is the definition site of a named symbol, verifiable with one rg command. Deterministic — nothing to rig.

Strong baselines, disclosed

Not just naive file dumps: keyword search (ripgrep) and a vector baseline that returns the top 8 entries of NeuralMind’s own vector index — a symbol’s name, module and docstring, not its code, so its token count is a floor. Losses shown, not hidden.

Pre-registered queries

Queries are committed in evals/public/manifest.json before tuning. Every one is reported. Re-runs have matched recall and found-rate exactly on every machine compared; token counts, and on one repo the vector-RAG baseline's MRR, can differ slightly between machines (how much).

requests @ 0e322af877

14 pre-registered queries · tokenizer: tiktoken o200k_base

BackendGold-file recallMean tokens/queryvs full-file
full-file1.0041,7291×
ripgrep0.7926,5431.6×
embedding-rag1.00229181.9×
neuralmind1.0081651.2×

No NeuralMind gold-file misses on this repo.

click @ 874ca2bc1c

7 pre-registered queries · tokenizer: tiktoken o200k_base

BackendGold-file recallMean tokens/queryvs full-file
full-file1.0078,5141×
ripgrep0.7945,0591.7×
embedding-rag1.00220357.5×
neuralmind1.00670117.1×

No NeuralMind gold-file misses on this repo (echo-util, missed from the v4.6.0 run to v4.11.1, is found).

flask @ c12a5d874c

10 pre-registered queries · tokenizer: tiktoken o200k_base

BackendGold-file recallMean tokens/queryvs full-file
full-file1.0059,0131×
ripgrep0.8526,8912.2×
embedding-rag0.85272217.0×
neuralmind1.0086168.5×

No NeuralMind gold-file misses on this repo (xfile-dispatch-context, missed by v4.11.1, is found).

rich @ 7f580bdcf0

9 pre-registered queries · tokenizer: tiktoken o200k_base

BackendGold-file recallMean tokens/queryvs full-file
full-file1.00232,4831×
ripgrep1.0043,4375.4×
embedding-rag1.00236985.5×
neuralmind1.00961242.0×

No NeuralMind gold-file misses on this repo.

Read the losses too: NeuralMind finds the gold file on all 40 queries, but 40 is a small sample: on the 150-question retrieval eval it misses 10, listed in bench/retrieval. embedding-rag is the top 8 entries of NeuralMind's own vector index, nothing added. NeuralMind's recall is at or above it on every repo, but it is cheaper on all four, and it still ranks the gold file higher on flask (MRR 0.74 vs 0.72) and rich (0.94 vs 0.83). Its token count is a floor: it sends a symbol's name, module and docstring, not code, where NeuralMind spends the difference on a structured context (project map, the query's other candidates, eight ranked hits). Scoring reuses neuralmind/quality.py verbatim — the same metric code the CI quality gate runs. Full method, baselines, and raw per-query data in the methodology. These tables were regenerated at v4.12.0, with the neuralmind backend run read-only and its tokens counted with the benchmark's tokenizer — what changed.

# Reproduce it yourself — no trust required. Recall and found-rate should match
# the tables above exactly; token counts can differ slightly by machine: the
# GitHub-hosted CI runners without AVX-512 land up to 0.8% off on a per-repo mean.
git clone https://github.com/dfrostar/neuralmind && cd neuralmind
pip install -e . tiktoken
NEURALMIND_ORT_THREADS=1 python -m evals.public.run

Community numbers

Real repos, submitted via pull request

Each entry below was produced by running neuralmind benchmark . --json on the submitter's own repository and PR'd into the dataset. CI validates every submission against a schema. NeuralMind never uploads anything automatically — these are deliberate, auditable contributions.

—
Loading…

Does the ratio hold as repos get bigger?

Each point is one submission — graph node count (a proxy for codebase size) against the average reduction ratio vs the CLI's fixed 50,000-token estimate, the one ratio every row shares. That ratio is 50,000 ÷ tokens per question, so this chart shows how context size moves with repo size, not the ratio against each repo's own code: v4.5.0+ submissions add that, in the table below. Hover any point for the project, language, and exact numbers.

Reduction by language

Average reduction ratio per language, with the submission count under each bar — so you can tell "this is solid" apart from "n=1, take with salt".

All submissions

The dataset behind both charts. On v4.5.0+, neuralmind benchmark . --naive-50k --json reproduces a row's fixed-estimate ratio and neuralmind benchmark . --json its ratio against the measured code — run them on your own repo and the numbers should reproduce in the same range.

Project Language Nodes vs 50K est. vs measured code Wakeup tok Query tok Model Submitted by Date Notes
Loading submissions…

Click a column header to sort. Data loads from community-benchmarks.json at page load — no server, no tracking.

Contribute

Add your repo's numbers

The dataset gets stronger with every repo it covers — especially across different languages and sizes. Five minutes, two commands, one PR:

pip install neuralmind
cd /path/to/your-repo
neuralmind build .
# prints your numbers + a ready-to-share JSON blob
neuralmind benchmark . --contribute

Then open a PR adding the blob as one entry in docs/community-benchmarks.json (fields enforced by community-benchmarks.schema.json), or file it via the benchmark submission issue template. CI validates the entry; this dashboard updates automatically once it merges.

5-minute walkthrough →