SciTeX Live Paper (scitex-live-paper)

The web-readable foundation for live, AI-verifiable research papers.

Full Documentation · uv pip install scitex-live-paper[all]

Problem and Solution

Quick Start

from scitex_live_paper import bundle

loaded = bundle.load("./bundle/")
print(len(loaded.claims), "claims,", loaded.paper_state.stage)

# Render the static site (viewer + claims sidebar + DAG + index)
scitex-live-paper render ./bundle/ --out ./site/

For a runnable walk-through see examples/example_live_paper.py.

Demo

A runnable load-and-summarise demo lives in examples/example_live_paper.py (run every example with examples/00_run_all.sh):

python examples/example_live_paper.py
# bundle: bundle-min
# claims: 3
# manuscript: manuscript.pdf
# paper stage: preprint

Installation

uv pip install "scitex-live-paper[all]"
pip install "scitex-live-paper[all]"
pip install scitex-live-paper           # CLI + library only

Recommended: uv pip install scitex-live-paper[all] — uv's Rust resolver handles the SciTeX dep set in 1-3 min where pip's serial backtracker can take 30+ min on the full extras. Plain pip install still works, as shown above.

_{Table 1. Optional-dependency extras.}

Without [clew] the M2 api/claim/verify and api/claims/verify endpoints stay reachable but degrade gracefully (every per-claim response carries fallback: true + a clear reason); install [clew] to get the real verify_claim() call.

Working on scitex-live-paper itself? See Dev quickstart — editable install, render the in-tree fixture bundle, bundle-layout contract, and where the Django app pattern is mirrored from.

Architecture

scitex-live-paper is deliberately thin. It is a consumer / rendering layer, not an authority on claims. If a feature requires extending the claim or DAG model, the change belongs upstream in scitex-clew, not here.

flowchart TD
    bundle["accepted manuscript bundle<br/>(LaTeX + claims.json + DAG + figz + provenance)"] --> lp["scitex-live-paper<br/>(thin renderer)"]
    lp --> viewer["viewer (PDF.js)"]
    lp --> claims["claims panel"]
    lp --> dag["DAG nav (mermaid)"]
    lp --> badge["badge (verification status)"]

_{Figure 1. Bundle in, four surfaces out — the package renders, upstream owns the models.}

_{Table 2. Ownership boundaries — who owns what.}

Roadmap

_{Table 3. Milestone roadmap.}

Issues for M1 are filed in this repo — see open issues.

3 Interfaces

from scitex_live_paper import BundleContext, BundleSource, PaperState, bundle

loaded = bundle.load("./bundle/")

Environment Variables

_{Table 4. Environment variables referenced by this package.}

Part of SciTeX

scitex-live-paper is part of SciTeX.

Upstream dependencies (this package consumes them; it does not define their models): scitex-clew (claim model, DAG, verification), scitex-writer (bundle layout + Django viewer pattern), scitex-hub (Django host, auth), scitex-ui (viewer widgets). Producer: scitex-agentic-journal (accepted bundle + re-review verdicts).

Four Freedoms for Research

0. The freedom to run your research anywhere — your machine, your terms.
1. The freedom to study how every step works — from raw data to final manuscript.
2. The freedom to redistribute your workflows, not just your papers.
3. The freedom to modify any module and share improvements with the community.

AGPL-3.0 — because we believe research infrastructure deserves the same freedoms as the software it runs on.

License

AGPL-3.0-only. See LICENSE.