0
0
Fork 0
The Vesuvius Challenge monorepo
  • Python 47.4%
  • C++ 35.1%
  • Jupyter Notebook 11.1%
  • JavaScript 2.1%
  • C 1.3%
  • Other 2.9%
Find a file
Jeff Moe 096e8c85bb orchestrate: default beat timeout 20m -> 40m
Beats that view images and run analyses were hitting the 20m kill twice
(journal entries still landed; analysis was truncated). Interval unchanged.

Co-Authored-By: Kimi K3
2026-10-09 06:37:56 -06:00
.github VC3D: browse large automated fiber collections - Automated Fiber Volumes (#1930) 2026-10-05 11:49:30 +00:00
.kilo Add /resume command: overseer context recovery after session loss 2026-10-08 21:07:05 -06:00
deprecated Deprecate Discord chatbot 2026-08-25 08:01:42 +02:00
dinovol add contrastive emb from vc pcls , loss, dataset sampling (#1556) 2026-08-21 19:19:15 +00:00
foundation NO accept terms 2026-10-03 19:45:57 -06:00
ink-detection/optimized_inference ink-detection: select MPS on Apple Silicon and fix the autocast device type (#1812) 2026-10-08 11:09:14 -05:00
lasagna lasagna: tifxyz_format.md documents scale as grid cells per voxel (1/step) (#1922) 2026-09-30 22:22:53 +02:00
log research journal: 11:21 UTC beat — sampler recovered, ink3d assessment: real signal, rims refuted, legibility open 2026-10-09 05:38:04 -06:00
scripts orchestrate: default beat timeout 20m -> 40m 2026-10-09 06:37:56 -06:00
scrollprize.org scrollprize.org: one sponsor list on the homepage, smaller gifts behind "Show more" (#1976) 2026-10-05 08:13:46 -07:00
segmentation Optimize DecohesionTransform using F.conv1d (#201) (#1072) 2026-07-17 15:33:39 -05:00
spiral-fitting fit_spiral_fast: runtime perf overlay for spiral fitting 2026-10-08 20:28:23 -06:00
vesuvius Merge branch 'upstream' 2026-10-08 11:08:03 -06:00
volume-cartographer vc3d-mcp: agent control of VC3D via kilo.json MCP server 2026-10-08 20:28:13 -06:00
.gitignore autonomy hardening: model pin, task verify/timeout hooks, zero-human mission 2026-10-08 20:51:52 -06:00
.gitmodules Discord chatbot (#287) 2025-07-13 13:21:01 +02:00
AGENTS-FORK.md user systemd services, open permissions with hard denies, no-sudo rule 2026-10-08 22:02:02 -06:00
AGENTS.md add scroll anatomy doc (#1943) 2026-10-01 14:13:44 -03:00
CLAUDE.md Contribution guidelines (#1410) 2026-08-12 16:59:37 -05:00
CONTRIBUTING.md Update CONTRIBUTING.md 2026-09-24 09:33:35 +02:00
kilo.json user systemd services, open permissions with hard denies, no-sudo rule 2026-10-08 22:02:02 -06:00
LICENSE Initial commit 2024-11-19 09:03:36 -05:00
MISSION.md gpuq cancel (queue-owned jobs only); autofix skips review-* files 2026-10-09 04:38:51 -06:00
README.md Deprecate Discord chatbot 2026-08-25 08:01:42 +02:00
REMOTE.md vc3d-mcp: agent control of VC3D via kilo.json MCP server 2026-10-08 20:28:13 -06:00
SCROLL_ANATOMY.md add scroll anatomy doc (#1943) 2026-10-01 14:13:44 -03:00
USAGE.md Download usage 2026-10-08 10:19:54 -06:00

🏛️ villa

MIT licensed Stars Discord chat

Vesuvius Challenge is a machine learning and computer vision competition to read the Herculaneum scrolls.
This repository contains the source code for Vesuvius Challenge: scroll tools, libraries, our website, data processing scripts, and more.


Libraries for Accessing Scrolls

vesuvius

A Python library for accessing CT scans of ancient scrolls, and for training and running the ML models used throughout the pipeline (e.g. surface prediction).


Machine Learning, Dataset & Rendering Tools

foundation

Tools to build/manage scroll datasets and cloud infrastructure, including photogrammetry masking.

ink-detection

Training and inference tools for Vesuvius Challenge ink detection models, built on the model that won the 2023 Grand Prize.
Originally developed by Youssef Nader and Luke Farritor, extended by the Vesuvius Challenge team.

dinovol

A self-supervised 3D DINO implementation for learning volumetric representations from scroll CT scans.


Automatic Unwrapping (Segmentation) Pipelines

VC3D (surface tracer)

A semi-automatic segmentation pipeline to extract papyrus sheets from CT scans of ancient scrolls. As of September 2025, it is the approach used by the Vesuvius Challenge team. Developed by Hendrik Schilling and Sean Johnson as a fork of Volume Cartographer.

lasagna

A PyTorch-based optimization framework for growing and refining papyrus surface meshes, offered as an alternative to VC3D's GrowPatch. It can jointly optimize several stacked sheets so they stay consistent with each other, and also drives fiber tracing.

spiral fitting

A fully automatic unwrapping pipeline that fits a single, globally coherent spiral to an entire scroll by deforming an ideal spiral to match traced patches, fiber skeletons, and winding annotations. Originally developed by Paul Henderson.


Supporting Resources

scrollprize.org

Source for the Vesuvius Challenge website.

Hugging Face

Released model checkpoints.

Weights & Biases

Training run logs.


Deprecated

thaumato-anakalyptor

A semi-automatic segmentation pipeline to extract papyrus sheets from CT scans of ancient scrolls.
Originally developed by Julian Schilliger. Superseded by VC3D and lasagna.

vesuvius-c

A single-header C library for accessing CT scans of ancient scrolls.

crackle-viewer

A GUI tool to inspect and label ink on virtually unwrapped segments of ancient scrolls.
Originally developed by Julian Schilliger.

discord_chatbot

A Retrieval-Augmented Generation chatbot for answering questions from Discord chat history.