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.
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
overheadandreference, stateeef_pos(3,); supported_target_kindsincludesreference_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 and operator microphone | the OpenCastor iOS app's Eval mode, 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sacpaint-0.2.1.tar.gz.
File metadata
- Download URL: sacpaint-0.2.1.tar.gz
- Upload date:
- Size: 98.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
20a71f6a6542be3a465f5678d2dcfcaf55ff9f10ff5bbe913896605cc4745806
|
|
| MD5 |
fb129ae0badc351c3a11cece28afac9a
|
|
| BLAKE2b-256 |
85681eb728ae35a6e4adb2c272073961f6543a5ccf0a5a83e0c9b485f52f61db
|
File details
Details for the file sacpaint-0.2.1-py3-none-any.whl.
File metadata
- Download URL: sacpaint-0.2.1-py3-none-any.whl
- Upload date:
- Size: 83.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
05ae2283797aaa8fc3fd2a4b26f86e2baa9afa2074a4638ef907f464d9e36150
|
|
| MD5 |
8feebdbcf82af72140dfc63f98e7a94e
|
|
| BLAKE2b-256 |
a999068c125db006a2cf112368ce69e7345fc601fa50986c20f3942c4c0f4260
|