Skip to main content

Sacramento PaintBench (sacpaint)

A physical-AI benchmark on Inspect Robots: a robot with a pen must reproduce a fixed reference drawing from camera feedback. One fixed prompt, one pinned reference image, geometric scoring that anyone can recompute offline from a photo. No printed markers, no special fixture: a sheet of paper on a desk and any camera, including an iPhone.

Can a general-purpose frontier model reproduce a visual target with a physical tool, using camera feedback to correct itself, with no task-specific training?

The built-in reference is a simplified Sacramento composition: the Tower Bridge above the Capitol dome and cupola, joined by the Capitol Mall, two building masses, a horizon. Its SHA-256 is the benchmark's identity. The physical sheet is 150 × 200 mm (A5 or half-letter with margins), small enough for a desk arm such as the SO-ARM101 to reach every corner.

reference

Sixty seconds, no robot

pip install sacpaint
sacpaint score photo-of-my-drawing.jpg      # any photo of a finished sheet -> score + overlay

score finds the sheet in the photo (markers if present, otherwise the largest bright quadrilateral, otherwise corners you pass with --corners), rectifies it to the canonical canvas, and writes three files next to the photo: the rectified canvas, an overlay with the reference ink in red, and a JSON breakdown. That is the whole "process a new eval" path for a drawing made by any robot, any policy, any hardware.

The full benchmark, in the built-in mock plotter world:

sacpaint run --policy sacpaint_trace --embodiment sacpaint_plotter --no-rerun --no-prompt   # oracle, composite ~0.98
sacpaint run --policy sacpaint_idle  --embodiment sacpaint_plotter --no-rerun --no-prompt   # floor, 0.00
sacpaint export logs --out submission --label oracle                                          # publishable bundle

With a frontier model driving the same mock world (needs pip install inspect-robots-agent and a key):

ANTHROPIC_API_KEY=... sacpaint run --policy agent --model anthropic/claude-fable-5 --embodiment sacpaint_plotter -- -P images=on_demand

No API key? One flag runs the same policy through a Claude subscription (the Claude Code CLI, logged in on the machine) for development runs. Scores from this path are labelled wire=claude-code-cli and are not leaderboard-comparable; see docs/subscription.md.

sacpaint run --subscription --model haiku --policy agent --embodiment sacpaint_plotter --max-llm-calls 40 --no-rerun --no-prompt

The prompt

Fixed. Do not tune it per model.

Draw the reference image on the canvas with the pen. You may look at the overhead camera to inspect your work and make corrections. Stop when you believe the drawing is complete.

The model receives the reference as an image stream named reference and the canvas as a stream named overhead, because the agent policy attaches camera frames to observations and the instruction cannot carry an image. Every embodiment exposes those two streams.

Scoring

All scorers are pure readers of the final canvas. Nothing calls a model. The final canvas is the observe_parked() frame (pen lifted clear), rectified unless the embodiment marks it canonical, then thresholded to ink.

Scorer Weight What it measures
landmark_geometry 0.45 Per landmark: precision × recall of ink inside its box at 1% of the canvas diagonal (2.5 mm) after centroid alignment (presence), times a centroid-offset term (position). Plus relations (tower over dome, same x, horizon above tower), gated on both landmarks being present.
structure 0.30 Precision × recall of all ink within 2% of the diagonal (5 mm) of reference ink. Product, not F1, because a dense scribble recalls everything.
discipline 0.15 1 − fraction of ink farther than 2.5% of the diagonal (6 mm) from any reference ink, scaled down past 4× the reference's ink. Blank canvas scores 0.
efficiency 0.10 1 − steps/max_steps for a declared finish; scaled by structure in the composite so finishing a bad drawing fast earns nothing.
composite The leaderboard number.

Calibration on synthetic canvases:

Canvas composite landmark structure discipline
perfect trace 0.98 1.00 1.00 1.00
perfect trace photographed at an angle, plain sheet, rectified 0.97 0.97 1.00 1.00
hand wobble, σ = 1 mm 0.97 0.97 1.00 1.00
whole drawing shifted 5 mm 0.77 0.63 1.00 0.69
top half only (bridge, no dome) 0.53 0.38 0.55 1.00
random scribble, 30 / 60 / 400 lines 0.30 / 0.42 / 0.33 0.32 / 0.47 / 0.33 0.28 / 0.41 / 0.43 0.33 / 0.35 / 0.09
blank 0.00 0.00 0.00 0.00

Through the CLI with the framework's default guardrails, 3 epochs: oracle sacpaint_trace composite 0.984, sacpaint_idle 0.000.

Known properties: global registration counts (a 5 mm offset is a placement error, by design); a dense random scribble still collects about 0.3 to 0.4 because the reference covers much of the canvas; the tower, dome and road dominate through their weights.

Tracks

Track Memory across episodes Camera Measures
Cold none -P images=on_demand, never called raw open-loop competence
Closed loop (default) none throughout self-correction within one drawing
Learning prior attempts via inspect-robots summarize + -P prior_learnings= throughout improvement across 5 canvases

The learning track reuses the framework's own summarize / prior_learnings mechanism, so the "memory" is an auditable markdown file with a recorded hash. Report initial, final, best-of-5, and slope per attempt.

Your own reference in two commands

sacpaint new mytown --canvas 210x297     # writes ~/.sacpaint/references/mytown.spec.json + a preview PNG
sacpaint run --task sacpaint/mytown --policy sacpaint_trace --embodiment sacpaint_plotter -- -E reference=mytown

A reference is a JSON file of polylines grouped by landmark (millimetres, origin bottom-left, y up), optional landmark weights and boxes, relations (above, left_of, same_x), and tolerances. Every spec in ~/.sacpaint/references/ registers as the task sacpaint/<name> the moment the package is imported. The built-in spec is at src/sacpaint/assets/sacramento-line-v0.spec.json; copy it, edit it, done.

Real robots

Any embodiment that exposes this contract runs the benchmark unchanged:

  • action space eef_abs_pose, dims (x, y, z) in metres in the canvas frame (x right, y up the sheet, z above the paper; the pen marks at z ≤ 0.002 m, travels at z ≥ 0.005 m);
  • images overhead and reference, state eef_pos (3,);
  • supported_target_kinds includes reference_drawing;
  • observe_parked() lifts the pen clear and returns a fresh observation;
  • corners of the sheet in the overhead frame, if known, as observation.extra["canvas_corners"] (four [x, y] pairs, 0..1, TL TR BR BL); otherwise the scorer finds the sheet itself.
Body How
Mock plotter (built in) --embodiment sacpaint_plotter, options -E reference=NAME -E photo_mode=sheet
OpenCastor + SO-ARM101 with signed receipts docs/opencastor.md: --embodiment opencastor
iPhone as the overhead camera, corner marker, and operator microphone the OpenCastor iOS app's Eval mode (TestFlight build 76): frames and tapped corners go to the robot console, the embodiment polls them; see docs/opencastor.md
Any other arm implement the contract above; inspect-robots-so101 (LeRobot, joint space) is a fallback body that needs the agent's move_joints

Publishing a run the way robocurve does

sacpaint export logs --out submission --label opus

produces the layout of robocurve's published run datasets (clapboardbench):

submission/
 ├── README.md                     # provenance, reference hash, how to recompute
 ├── <log>.json                    # raw EvalLog: config, git rev, versions, scores, transcript
 ├── runs/README.md                # index table: model, policy, embodiment, status, composite, steps
 ├── runs/<label>-<n>.md           # one page per run: metadata, scores per epoch, per-landmark table,
 │                                 #   final canvas, the model's note for every tool call
 ├── html/                         # inspect-robots view reports (frames the model saw)
 ├── canvases/                     # the rectified final canvas and score JSON per trial
 ├── videos/                       # inspect-robots video (when ffmpeg is installed)
 └── reference.png, reference.sha256, rubric.json

sacpaint worldevals-entry prints the Benchmark(...) block for a WorldEvals catalog pull request.

Status

Piece State
Task sacpaint/line-v0, five scorers, three epochs done, registered via entry points
Mock plotter + oracle/idle policies done; the whole stack runs with no hardware
Marker-free rectification (given corners, ArUco, plain sheet) done, tested under perspective
sacpaint score / new / run / export / worldevals-entry done
--policy agent (frontier LLM) works against the mock; needs a key or the subscription shim
OpenCastor / SO-ARM101 embodiment see docs/opencastor.md
Hardware runs not yet
WorldEvals catalog entry after the first real-robot log

Development

git clone https://github.com/craigm26/sacpaint && cd sacpaint
uv venv && source .venv/bin/activate && uv pip install -e ".[dev,agent]"
pytest

Regenerate the built-in assets (only when the reference itself changes; it re-versions the task):

python -c "from sacpaint.reference import write_assets; write_assets('src/sacpaint/assets')"

MIT.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sacpaint-0.2.2.tar.gz (98.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sacpaint-0.2.2-py3-none-any.whl (83.3 kB view details)

Uploaded Python 3

File details

Details for the file sacpaint-0.2.2.tar.gz.

File metadata

  • Download URL: sacpaint-0.2.2.tar.gz
  • Upload date:
  • Size: 98.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.5

File hashes

Hashes for sacpaint-0.2.2.tar.gz
Algorithm Hash digest
SHA256 12f39f5f32798edc2683ab91eb9eadb714bc568c39941007117b5b787e26506f
MD5 fcf97f0c9d636dd787f75f1b1f322c99
BLAKE2b-256 b622234356cc61922d46f1fd903bfcdd50feb0a5d0165e2e8f524aeff3375f54

See more details on using hashes here.

File details

Details for the file sacpaint-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: sacpaint-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 83.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.5

File hashes

Hashes for sacpaint-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 dbf302250a4569bc3e31e02172f252392a9107ae3866aba9853e92a4b4f6afc6
MD5 57bb72a9eaa914838c8ad16a4105c816
BLAKE2b-256 e917c266f5f09261fc26e5c9ef0de2c563a5325f0cdce187a325096d76d9b092

See more details on using hashes here.

Release history Release notifications | RSS feed

0.4.0

2 files

0.3.1

2 files

0.3.0

2 files

This release

0.2.2 This release

2 files

0.2.1

2 files

0.2.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page