Scriptoria — a research workbench for IIIF manuscripts.

---

Webscriptoria → 127.0.0.1:8000 · CLIscriptoria-cli "<manifest-url>"

Quickstart

git clone https://github.com/nikazzio/scriptoria.git
cd scriptoria
python3 -m venv .venv &&source .venv/bin/activate
pip install -e .
scriptoria

How It Works

flowchart LR
A[🔍 Discovery] --> B[📚 Library]
B --> C[📖 Studio]
C --> D[📤 Output]
A -. search/resolve .-> R[(Provider Registry)]
B -. local assets .-> V[(Vault)]
C -. manifests .-> V
D -. export jobs .-> V

Loading

Tab	What it does
Discovery	Resolve URLs, IDs, shelfmarks. Search 10+ IIIF libraries.
Library	Browse and manage your local manuscript collection.
Studio	Document workspace — Mirador viewer, OCR transcription, page actions.
Output	PDF inventory, thumbnail-level actions, export job queue.

Key Features

• 10+ IIIF providers — Vatican, Gallica, Harvard, Bodleian, Heidelberg, LoC, Archive.org, Cambridge, e-codices, Institut
• Provider registry — shared resolution for web UI and CLI
• PDF export profiles — local and remote high-res modes with quality presets
• Centralized HTTP — retries, exponential backoff, per-library network policies
• Local-first workflow — reproducible storage, no cloud dependencies

CLI

scriptoria-cli "https://digi.vatlib.it/iiif/MSS_Urb.lat.1779/manifest.json"

Any IIIF-compliant manifest URL works directly.

Documentation

🗂️ Docs Home	🚀 Getting Started
🏗️ Architecture	⚙️ Config Overview
💻 CLI Reference	📖 Wiki

Development

pytest tests/ # tests
ruff check . --fix # lint
ruff format .# format
ruff check . --select C901 # complexity

Troubleshooting

scriptoria: command not found

source .venv/bin/activate && pip install -e .

ruff: command not found

source .venv/bin/activate && pip install -r requirements-dev.txt

Port 8000 already in use

Stop the conflicting process and restart scriptoria.

Studio opens without a document

Expected. Open an item from Library, or use the recent-work hub at /studio.

---

_{Built for manuscript-heavy research workflows · GPL-3.0-or-later}