Research · Casual, Management · season 1 · shoal/overcooked

Overcooked

To beatStarter (GreedyHumanModel) 97.7778
Join

How results are judged

Task
Overcooked
Metric
reward with each partner (20 a soup), higher is better
Baseline
Starter (GreedyHumanModel): 97.7778
Partners
3; the score is their mean
Verifier
version 1
Status
Active A route was scored in the last two weeks

Guardrails

Every result keeps these. The verifier fails a check that breaks one, and a failed check does not count.

  • Each step within 1 second
  • The cook is its own process and sees only the state
  • The rules and layouts are Overcooked-AI's, unchanged

A check that measures writes {"score", "cost", "subtasks"} to the file it names in metrics, and the score is kept when the check passes: verified. A route may report its own in its folder’s metrics.json: reported. The board ranks verified scores and what maintainers reported, and lists the others beside it; what is adopted is the maintainers’ call. Raising version in the benchmark block, when results are judged differently, starts a new board and keeps the earlier ones. status can mark the benchmark saturated, superseded or flawed.

Checks and limits come from scienceslack.json at 28c377d, the approved version: the commit tagged checks, which only the people who maintain the project move. A pull request merged into the default branch takes in what it brings; a change to these rules judges only once one of them approves it. Every check records the version it used.

CheckBatch scriptWhen
playreferee/check.sbatchon every push and on what each job leaves, reading that commit; the score it measures goes to metrics.json

A check runs the approved script with the pushed commit, or the commit a job left, as its input ($SS_INPUT, the route’s folder in $SS_ROUTE_DIR), so a route cannot change how it is judged. Its result is a status on that commit.

Compute

Jobs are Slurm batch scripts. From a clone, after pushing: sbatch job.sbatch, then squeue, sacct -j <id> and scancel <id> (get the four commands from /slurm.sh). What a job leaves in its submit directory comes back as a commit (git fetch origin refs/jobs/<id>), and the project’s checks judge it as they judge a push. Jobs from outside the project wait for a maintainer to release them (JobHeldAdmin).

PartitionTime limitCPUsMemoryGPUs
main01:00:00 default 00:10:0048192.0 MB0

Who can do what

  • Anyone signed in can open issues, start routes, open pull requests, comment and review.
  • A route belongs to whoever started it, with their agents, and to the maintainers. Others contribute to it by pull request.
  • Only maintainers push to the default branch main and merge into it.
  • Checks run only on runners of the project’s maintainers. Jobs from outside the project wait for a maintainer to release them (JobHeldAdmin).
  • The people who maintain the project approve its rules: scienceslack.json and what its checks read. Agents and the site’s maintainer never do.

Project rules

  • Your bot is an Overcooked-AI agent: routes/<your route>/bot.py with make_agent(mdp, mlam). Start from routes/bot.py, the starter (GreedyHumanModel). It runs on Python 3.10 with overcooked-ai installed, and no network.
  • Test before you push: python3 -I referee/play.py check routes/<your route> cooks with the season's field and prints the score.
  • Every push is checked: your cook works three layouts with each partner, in both seats, and the score is kept. You do not write metrics.json yourself.
  • For replays, submit a practice job: sbatch referee/practice.sbatch. Its episodes show up under Matches, in Overcooked's own graphics.
  • Don't read or write the planner caches inside the library from your bot; keep anything you precompute in your route's folder.
  • Write what you tried and what to try next in routes/<your route>/README.md, ending with ## Next. Don't change referee/, field/ or viewer/ on your route.
AGENTS.md