requests
@ 0e322af877· 14 queries51.2× fewer tokens| Backend | Recall | Found | Tokens/query | MRR |
|---|---|---|---|---|
| full-file | 1.00 | 100% | 41,729 | 1.00 |
| ripgrep | 0.79 | 71% | 26,543 | 0.60 |
| embedding-rag | 1.00 | 100% | 229 | 0.92 |
| neuralmind | 1.00 | 100% | 816 | 0.93 |
How much context different approaches put in an agent’s window to answer a real code question, and whether the objectively correct file makes it in. Cost and correctness are reported together, because a token-reduction number with no correctness number attached is meaningless.
Every query was registered before tuning, every miss is published, and every number on this page is read from the committed run or from site/claims.json when the site is built.
git clone https://github.com/dfrostar/neuralmind && cd neuralmind pip install -e . tiktoken # source checkout ships the harness NEURALMIND_ORT_THREADS=1 python -m evals.public.run # clones the pinned repos, prints the table
The harness lives in the source tree, not the PyPI wheel, so run it from a clone. The repos are cloned at fixed commit SHAs and nothing in the run is random, so recall and found-rate should match the tables below exactly. Token counts can shift slightly between machines — CI runners without AVX-512 land up to 0.8% off on a per-repo mean; NEURALMIND_ORT_THREADS=1 matches CI’s setup (what moves, and the evidence). Raw per-query data is committed in bench/public/results.json; the query set is in evals/public/manifest.json.
Two kinds of result, side by side: retrieval, where NeuralMind gets the right code into the window in far fewer tokens, and task outcomes, where a pre-registered pilot found it made no difference.
Retrieval · what reaches the window
40 of 40
Keyword ripgrep, top five files whole: 32 of 40.
Reproducible31–67×
The baseline closest to how an agent works.
Reproducible51–242×
670–961 mean tokens per question against 41,729–232,483.
Reproducible93.3%
150 questions on 5 repos; 10 misses, listed.
ReproducibleTask outcomes · does the agent do better
18 vs 18
Of 20, without and with NeuralMind.
Pilot+0.0%
Median change with NeuralMind; 95% CI −5.2% to +8.6%.
Pilot53 vs 55
Of 60 each, without and with.
Pilot0
In 60 runs with its 28 MCP tools available.
PilotFewer tokens in the window isn’t the same as a cheaper or better agent, so we pre-registered a task-outcome benchmark and ran its pilot on 2026-10-20: 20 real bug-fix tasks, Claude Code with and without NeuralMind, 3 seeds each, 120 runs. The claim it tested, that NeuralMind lowers cost per task without solving fewer, is not supported.
| Per arm | Without | With NeuralMind |
|---|---|---|
| Tasks solved | 18 of 20 | 18 of 20 |
| Runs solved | 53 of 60 | 55 of 60 |
| Cost per solved task | $0.227 | $0.216 |
| Median turns per task | 10.3 | 10.8 |
| Median explore calls before the first edit | 4 | 4 |
Six design decisions, each aimed at a specific way a vendor benchmark usually fails.
Tokenizer: tiktoken o200k_base. Token counts are shown for every backend rather than a ratio, so the columns compare directly, including where NeuralMind is the more expensive one.
| Backend | Recall | Found | Tokens/query | MRR |
|---|---|---|---|---|
| full-file | 1.00 | 100% | 41,729 | 1.00 |
| ripgrep | 0.79 | 71% | 26,543 | 0.60 |
| embedding-rag | 1.00 | 100% | 229 | 0.92 |
| neuralmind | 1.00 | 100% | 816 | 0.93 |
echo-util, missed from the v4.6.0 run until v4.12.0, is found again.
| Backend | Recall | Found | Tokens/query | MRR |
|---|---|---|---|---|
| full-file | 1.00 | 100% | 78,514 | 1.00 |
| ripgrep | 0.79 | 71% | 45,059 | 0.60 |
| embedding-rag | 1.00 | 100% | 220 | 0.86 |
| neuralmind | 1.00 | 100% | 670 | 0.86 |
xfile-dispatch-context, missed in the v4.10.0 run, is found at v4.12.0. The plain vector baseline misses two of these ten queries.
| Backend | Recall | Found | Tokens/query | MRR |
|---|---|---|---|---|
| full-file | 1.00 | 100% | 59,013 | 1.00 |
| ripgrep | 0.85 | 80% | 26,891 | 0.65 |
| embedding-rag | 0.85 | 80% | 272 | 0.74 |
| neuralmind | 1.00 | 100% | 861 | 0.72 |
| Backend | Recall | Found | Tokens/query | MRR |
|---|---|---|---|---|
| full-file | 1.00 | 100% | 232,483 | 1.00 |
| ripgrep | 1.00 | 100% | 43,437 | 0.75 |
| embedding-rag | 1.00 | 100% | 236 | 0.94 |
| neuralmind | 1.00 | 100% | 961 | 0.83 |
Two loss modes, reported plainly. A benchmark that never reports a loss is not evidence, it is advertising.
Rendered from site/claims.json, the file CI holds every page to: each figure with the kind of evidence it is, where it was measured, and the command that reproduces it.
| Figure | What it is | Evidence | Source · reproduce |
|---|---|---|---|
| 51–242× | Fewer tokens than pasting every source file, across the 40 public-benchmark queries (per repo in the tables above). | Reproducible | docs/benchmarks/public.mdpython -m evals.public.run |
| 31–67× | Fewer tokens than ripgrep opening its top five files whole, same queries. An agent that reads only the matching lines pays less than this baseline; that is not measured. | Reproducible | docs/benchmarks/public.mdpython -m evals.public.run |
| 78.6× | psf/requests v2.32.3, neuralmind benchmark . at v4.5.0: the measured code the index covers over the tokens each generic question cost. | Reproducible | docs/use-cases/benchmark-your-repo.mdgit clone --depth 1 --branch v2.32.3 https://github.com/psf/requests && cd requests && neuralmind build . && neuralmind benchmark . |
| 41.8× | The same requests run against the fixed 50K-token estimate: the legacy line the CLI prints beside the measured one. | Reproducible | docs/use-cases/benchmark-your-repo.mdgit clone --depth 1 --branch v2.32.3 https://github.com/psf/requests && cd requests && neuralmind build . && neuralmind benchmark . --naive-50k |
| 12–50× | Field reports measured by neuralmind benchmark before v4.5.0, against its fixed 50K-token estimate. A new run is not on this scale. | Field report | docs/wiki/Benchmarks.mdneuralmind benchmark <your repo> --naive-50k |
| 48.8× | One field report: a ~9,300-node private TypeScript codebase through a major rebuild, against the fixed 50K-token estimate the CLI used before v4.5.0. | Field report | docs/use-cases/measure-memory-across-a-refactor.mdneuralmind benchmark <your repo> --naive-50k |
| 65.6× | Community submission: a 241-node JavaScript project, against the fixed 50K-token estimate. | Community | docs/community-benchmarks.jsonneuralmind benchmark . --naive-50k --json |
| 46× | Community submission: a 1,626-node Python project, against the fixed 50K-token estimate. | Community | docs/community-benchmarks.jsonneuralmind benchmark . --naive-50k --json |
| 5.1× | The ~500-line CI fixture, measured at v4.3.4. It moves with retrieval changes; CI gates only the floor below. | Reproducible | docs/wiki/Benchmarks.mdpython -m tests.benchmark.run |
| 4.0× | The CI regression floor on that fixture: the build fails below it. | CI-gated | docs/wiki/Benchmarks.mdpython -m tests.benchmark.run |
| 5.5× | Average reduction scripts/demo.sh prints across its three bundled-fixture queries. | Reproducible | scripts/demo.shbash scripts/demo.sh |
| 5.7× | One query in the same demo. | Reproducible | scripts/demo.shbash scripts/demo.sh |
| 8–16× | TurboVec’s 4-bit index vectors against float32: size, not tokens. | CI-gated | docs/wiki/Benchmarks.mdpython -m evals.parity.run |
| — | ripgrep (query keywords, top five files opened whole) found the gold file on 32 of 40 public-benchmark queries; NeuralMind on 40 of 40 | Reproducible | docs/benchmarks/public.mdNEURALMIND_ORT_THREADS=1 python -m evals.public.run |
| — | A gold file in the top five for 93.3% of the 150-question retrieval eval (30 pre-registered questions on each of requests, click, flask, rich and NeuralMind's own repo); 10 misses, listed per question | Reproducible | bench/retrieval/on-v4.12/report.mdpython -m evals.retrieval.run |
| — | NeuralMind's assembled context costs 670-961 mean tokens per question (per repo) on the public benchmark; pasting every source file costs 41,729-232,483 | Reproducible | docs/benchmarks/public.mdNEURALMIND_ORT_THREADS=1 python -m evals.public.run |
| — | Synapse recall never lowers top-k hit rate, at a neutral token budget | CI-gated | docs/wiki/Benchmarks.mdpython -m tests.benchmark.run |
| — | Faithfulness vs naive truncation at a matched token budget: CI fails if the mean delta falls below -0.10 (built-in backend, mean of 3 runs on the reference fixture). At v4.12.0 it measured +0.265 (0.839 vs 0.574 expected-fact recall) with CI's command on one machine, where v4.11.1 measured +0.027; at v4.3.4 CI measured -0.054, a loss the site published. | CI-gated | docs/wiki/Benchmarks.mdpython -m evals.faithfulness.runner --run |
| — | TurboVec fact recall 0.800 vs chroma float32 0.744, identical top-k hit@4 | CI-gated | docs/wiki/Benchmarks.mdpython -m evals.parity.run |
| — | Task outcomes, pilot: on 20 pre-registered bug-fix tasks, Claude Code with and without NeuralMind solved the same number of tasks at no measurable difference in cost; the agent called none of NeuralMind's MCP tools | Pilot | bench/task_outcome/pilot/report.txtpython -m evals.task_outcome.run --tasks evals/task_outcome/tasks.json --out bench/task_outcome/pilot --model claude-sonnet-5-5 --seeds 3 --tool-venv <venv with neuralmind==4.15.1> --test-python <venv>/bin/python --work-dir <scratch> && python -m evals.task_outcome.analyze bench/task_outcome/pilot |
These four repos are public so the numbers can be audited. The number that decides anything for you is the one from your codebase: neuralmind benchmark . prints it.