# Unscroll

- **Event:** [Meta Global AI Developer Hackathon](https://cerebralvalley.ai/e/meta-ai-developer-hackathon)
- **When:** Oct 26, 12:00 PM – Nov 4, 9:00 PM (EST)
- **Where:** Online
- **Team:** [Jayachandiran Udayakumar](https://cerebralvalley.ai/u/jayaudaykmar)
- **GitHub:** https://github.com/Jayaudaykmar26589/unscroll
- **Demo video:** https://youtu.be/ydY7hmCKrHg
- **Gallery:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery
- **Page:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2182

Unscroll: scholar-guided tracing of the Herculaneum scrolls, measured against the sheets people traced by hand.

The Herculaneum scrolls were carbonized by Vesuvius in 79 AD and can only be read from CT scans, by following one papyrus sheet through thousands of slices where neighbouring sheets are crushed together. The Vesuvius Challenge's 2026 open-problems list says no method yet traces a complete, correct surface automatically, and names a trace switching onto a neighbouring sheet among the failures it sees most. A trace that switches reads the wrong page, and nothing warns you. Unscroll is for the volunteers and researchers who trace scrolls for the Vesuvius Challenge: it tells them which traces slipped, ranks which to check first, and exports traces in the tifxyz format their tools (VC3D) read.

Unscroll turns one click on a CT slice into a SAM 3.1 trace and scores it, with exact point-to-triangle distances, against layers released by the Vesuvius Challenge community. That paired test found the slice where traces go wrong, the first one, and a local walk from the click fixes it. On 74 clicks never used while building the fix, the share of each trace within 40 microns of the hand-traced sheet doubled, from 25% to 50% (better on 50 clicks, worse on 19, p = 0.0002). As a control, a classic optical-flow tracer from the same start scores 4.5 points lower; on the 15 development clicks that comparison is a tie, and we say so.

A Muse Wonder agent extends traces on its own: it chose where to re-seed, spent a fixed budget of GPU runs, and decided which runs to exclude, with no person stepping in during its sessions. It inspects a trace, re-seeds where tracking stops, launches Kaggle GPU runs, scores and unrolls the result, and checks each seam with continuity numbers plus a Muse Spark visual verdict. It caught its own first re-seed jumping to another sheet and excluded three runs, with reasons logged.

What stands between a trace and readable text is also measured. Wobble from slice to slice, not distance, destroys the ink. Smoothing Unscroll's own trace on a sheet with known Greek text raises agreement with the official ink map from 0.21 to 0.73, against 0.83 for the official surface: broad strokes, not letters. A cost-of-reading test does this for one, five and ten scholar clicks. Unscroll has not read any new text; it measures exactly how far from reading a trace is.

Try it on any of the 89 measured clicks: https://jayaudaykmar26589.github.io/unscroll/viewer/explore.html · replay the agent call by call: https://jayaudaykmar26589.github.io/unscroll/viewer/agent.html

Animated two-minute walkthrough of the whole pipeline, drawn live from the data: https://jayaudaykmar26589.github.io/unscroll/viewer/how.html

Everything in the repository was built during the hackathon (Oct 27 to Nov 4). Used, not built, and credited: SAM 3.1 and the Muse models (Meta), the 2023 Vesuvius Grand Prize ink model (MIT), and the Scroll 1 CT and human-traced layers (EduceLab-Scrolls / Vesuvius Challenge, CC BY-NC 4.0, used with the team's permission). Tests: 155 passed. Interactive Story page, no install: https://jayaudaykmar26589.github.io/unscroll/viewer/story.html

## More from Meta Global AI Developer Hackathon

- [Sado](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2179)
- [Uncrumple](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2180)
- [Curtain](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2181)
- [worldoverlay](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2183)
- [mesoloplswin](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2184)
- [Mist Groups](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2185)

---

Markdown version of https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2182. Site index for agents: https://cerebralvalley.ai/llms.txt · full text: https://cerebralvalley.ai/llms-full.txt