Skip to content

benchflow-ai/FrontierPhysics

Repository files navigation

FrontierPhysics

Discord GitHub WeChat

Are AI agents good physicists?

FrontierPhysics: Benchmark how AI agents do frontier physics research.

Contributing · Benchmark Protocol · BenchFlow SDK · Discord

What is FrontierPhysics?

FrontierPhysics measures whether AI agents can complete authentic, specialist-level physics workflows: building physical models, deriving quantities, running numerical simulations, analyzing scientific data, and producing research artifacts.

The primary benchmark condition gives agents the task, environment, and tools without mentor skills. Each task also ships a reviewable mentor package as a solvability control. A strong with-skill result helps distinguish a genuine capability limit from a broken task, environment, oracle, or verifier.

Goals:

  • Build a rigorous public benchmark for advanced physics research
  • Measure independent agent capability through no-skill pass rate
  • Use mentor-guided control runs to validate task solvability
  • Preserve scientific provenance, trajectories, diagnostics, and artifacts
  • Cover theoretical, computational, experimental, and instrumentation work

Quick Start

git clone https://github.com/benchflow-ai/FrontierPhysics.git
cd FrontierPhysics

# Install or upgrade to the latest stable BenchFlow CLI.
uv tool install --upgrade benchflow

# Install repository tooling from the committed lockfile.
uv sync --locked

# Validate a native task.md package.
bench tasks check tasks/surface-ion-trap-shuttling

# Oracle must pass before agent runs.
bench eval run \
  --tasks-dir tasks/surface-ion-trap-shuttling \
  --agent oracle \
  --sandbox docker

Runnable benchmark tasks live under tasks/. FrontierPhysics uses uv.lock for reproducible repository tooling while the bench CLI runs task validation and evaluations.

See experiments/README.md for paired no-skill and with-skill commands.

API Keys

Running hosted agents may require provider credentials or an authenticated local agent session. Export only the credentials required by the selected agent. Keep secrets in an ignored .env or .envrc; never commit them.

Creating Tasks

FrontierPhysics tasks are native BenchFlow task.md packages:

tasks/<task-id>/
  task.md
  environment/
    Dockerfile
    skills/
  oracle/
    solve.sh
  verifier/
    test.sh
    test_outputs.py

See CONTRIBUTING.md for scientific-quality requirements, mentor-skill policy, metadata, validation, and review evidence.

Get Involved

License

Apache 2.0. Bundled third-party components retain their own license notices; see NOTICE.

About

FrontierPhysics: Benchmark how AI agents do frontier physics research.

Topics

Resources

License

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages