Project website · Quickstart · 12 public tasks · Evaluation
Automatically looping demo preview. An illustrative scientific reproduction workflow, not a benchmark result.
Before a research agent can be trusted to discover something new, can it reconstruct and verify what science already knows?
PaperBenchX tests the complete scientific reproduction workflow: translate a published paper into the intended experiment, execute it in a domain-native environment, and produce evidence another researcher can independently regenerate. A plausible result is not enough if the submitted procedure models the wrong system or cannot reproduce the evidence.
| Benchmark scope | Public release | Restricted evaluation set |
|---|---|---|
| 93 tasks across 12 research areas | 12 representative tasks, one per research area | 81 tasks, maintained separately with limited access |
The public tasks let the community run agents, inspect evaluation methods, debug reproduction workflows, and study the strengths and limitations of research agents. The restricted set supports continued evaluation while reducing contamination and preserving longer-term benchmark validity. It is not included in this repository; access is managed separately by the maintainers.
Task distribution from the PaperBenchX paper figure published on the project website. This figure describes the full benchmark, not only the 12 public tasks.
Three capabilities:
- Modeling: recover the scientific model, assumptions, geometry, parameters, and target observables from the paper.
- Execution: use native scientific tools, interpret diagnostics, and establish that the intended computation actually ran.
- Validation: regenerate artifacts and connect numerical and scientific claims to the evidence that supports them.
All 12 public task packages include instructions, scoring details, environment configuration, and the corresponding evaluation resources. Their software and asset distribution conditions differ:
| Group | Tasks | What is provided | What you must provide |
|---|---|---|---|
| 9 tasks using noncommercial scientific stacks | 04–12 | Public environment configuration, scientific materials, and verifier resources; 04–11 include build recipes for their runtime stacks | Compute hardware |
| 3 tasks using commercial scientific software | 01–03 | Task instructions, scoring rules, runtime requirements, and the unified evaluation framework | An authorized HFSS installation/runtime image and a valid, reachable solver license |
Environment recipes are not a blanket redistribution license. Papers, datasets,
model weights, scientific software, and container components retain their own
terms. Task 12 bundles neither its observations nor its weights in this repository:
its build defaults to suermars/paperbenchx-mapgpt-r2r-full on DockerHub, with the
runtime version pinned in the task configuration. Building and running still
require sufficient storage and GPU hardware. See the
quickstart and
commercial HFSS guide before provisioning a run.
Each task link opens its scientific instructions. Detailed resource requirements are in the task catalog.
| ID | Research area | Representative task |
|---|---|---|
| 01 | RF antennas and arrays | Matching, isolation, and radiation in a CPW UWB MIMO antenna |
| 02 | RF metasurfaces and scattering | Polarization-dependent reflection and diffuse scattering |
| 03 | RF filters and frequency-selective surfaces | Dual-passband transmission and angular stability |
| 04 | Integrated photonic devices | Broadband differential phase in periodic SWG waveguides |
| 05 | Photonic crystals and topology | Unidirectional invisibility in a gain–loss Bragg grating |
| 06 | Metasurfaces gratings and plasmonics | Two resonance branches in a slotted multilayer grating |
| 07 | Optical computing | Brewster-interface spatial differentiation |
| 08 | Resonators filters and tunable devices | Polarization-selective transmission of cholesteric slabs |
| 09 | Computational chemistry | Short-time steering in pimarenyl-cation trajectories |
| 10 | Computational materials science | Elastic response and spin–orbit bands of monolayer MoS2 |
| 11 | Computational biology and bioinformatics | Reconstructing a human CRISPRi genetic-interaction map |
| 12 | Robotics and embodied AI | MapGPT mapping, prompting, and adaptive navigation |
Use Linux x86-64, Python 3.12+, Docker, and Docker Compose 2.27.0+. Run from the repository root:
python3 -m venv .venv
source .venv/bin/activate
python -m pip --isolated install --index-url https://pypi.org/simple -r requirements.txt
python scripts/runner_compat.py --apply
python run.py list
python run.py check --task allThese checks do not call a model or run a scientific experiment. To evaluate an agent, create a private configuration and fill the solving and judge API settings using the configuration guide:
cp .env.example .env
chmod 600 .envAfter editing .env, run a CPU task and inspect the results:
python run.py check --task 06 --host
python run.py run --task 06 --concurrency 1 --job-name first-task06
python run.py summary jobs/first-task06A full run consumes compute and model API calls. Read the task and its budgets
first. Tasks 09 and 12 each require a GPU and must run separately at concurrency 1.
Tasks 01–03 need your commercial runtime and license. Task 12's
NAV_LLM_BASE_URL is intentionally blank until you configure its local service.
For build-only deployment, alternate API protocols, or failure diagnosis, use the
complete quickstart.
Paper and task contract → executable submission → clean replay → evidence-based grading.
The original paper's evaluation figure and task-construction figure are available in the detailed protocol.
The agent submits a runnable reproduce.sh, source, and permitted inputs. The
verifier removes generated outputs, replays the workflow under task-specific
isolation and resource limits, and grades the regenerated evidence. Deterministic checks assess directly computable properties; where model-based judgment is required, the official evaluation uses GPT-5.6 Sol uniformly across all submissions to review scientific implementation and interpretation under a separately configured judging protocol.
Each task's tests/rubric.json defines its own weighted criteria. A report may
explain evidence, but cannot substitute for it. Missing or infrastructure-blocked
scores are not silently converted to zero: report scores with coverage and
failure counts. See evaluation details for agent/verifier
separation, result interpretation, and responsible comparison.
README.md Benchmark overview and navigation
README_HFSS.md Separate setup guide for commercial tasks 01–03
docs/ Quickstart, task catalog, and evaluation protocol
assets/ Small project logo, original paper figures, and demo video
run.py Unified Harbor launcher
.env.example Blank API and resource configuration template
requirements.txt Launcher dependencies
scripts/ Environment, replay, and evaluation runtime helpers
tasks/XX-task-name/
instruction.md Scientific goals and agent deliverables
task.toml Execution budgets and environment metadata
environment/
Dockerfile Scientific runtime image build
docker-compose.yaml Runtime services and mounts
requirements.txt Scientific runtime dependencies, where provided
paper/ Article and supplementary materials
starter_submission/
reproduce.sh Public reproduction entrypoint
src/ Starting code, where provided
inputs/ Fixed task inputs, where provided
tests/ Verifier entrypoint, rubric, and evaluation resources
Task instructions, runtime materials, and evaluation resources are deliberately
separate. tests/ is public for methodological inspection, but is kept separate
from agent-visible materials during evaluation. Task packages use
schema_version = "1.1" and names in paperbenchx/task-name format.
Each task owns its inputs; task09 initial states, task10 pseudopotentials and
task11 assay data are not shared across task directories. Fixed input files are
stored once under that task's environment/starter_submission/inputs/.
Docker builds provision the documented container paths from this directory;
workspace initialization copies the starter into the solving workspace.
Native replay uses the packaged inputs as its trusted baseline and rejects
changes to reserved files. Container paths such as /opt/pseudo/ and
/home/data/horlbeck/ remain available for compatibility.
The root requirements.txt serves the launcher and host evaluator, not the
task's scientific runtime. Task-level runtime dependencies use
environment/requirements.txt without changing their pinned versions. Task12
keeps its evaluator-only dependencies in environment/requirements-evaluator.txt.
Tasks without a separate dependency list or fixed inputs do not need empty files
or placeholder directories.
Local .env, runs/, and jobs/ are not public-release materials. Do not publish
credentials or redistribute restricted assets through logs. Restricted benchmark
tasks are not bundled in this release. This release does not include reference
solutions.
Use the demos to evaluate agents, inspect scoring, and diagnose scientific or infrastructure failures. When reporting results, disclose the task set, model and judge settings, budgets, attempts, coverage, and any access to public grading resources beyond the controlled agent inputs. A result on the 12 demos is not a result on the 81 restricted tasks.
The repository code is licensed under MIT. Third-party scientific software, papers, datasets, and model weights retain their applicable terms. The repository license does not grant ANSYS usage rights or restricted-set access.