Scriptoria — a research workbench for IIIF manuscripts.

---

Web  scriptoria → 127.0.0.1:8000  ·  CLI  scriptoria-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

📘 User Guide	🏗️ Architecture
⚙️ Config Reference	🌐 HTTP Client
📖 Wiki	🗂️ All Docs

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 · MIT}