amos689 / paperdelta
git clone https://github.com/amos689/paperdelta.git
v2.0.0 · 16d ago
Trace changed experiment results to the numbers, claims and figures in your LaTeX paper. Offline bilingual review, safe numeric patches and read-only MCP tools.
+3
stars, 24h · #8,314
+~14
stars, 7 days · #9,972
+93
stars, 30 days · #7,453
93
★ total · +14% this week
7
forks · 0 open issues
Star history (as recorded here)
LanguagePython
LicenseMIT
Created2026-10-03 (20d ago)
Last push16d ago
Watchers8
OwnerUser
GitHub topics
Links
README excerpt
Review how experiment changes affect an existing research paper. English · 简体中文 · Quick start · Releases · Feedback An accuracy result changes from **84.1% to 80.9%**. The abstract, table and appendix still repeat the old number; a **3.1 percentage point** improvement and an **outperforms baseline** claim no longer hold. PaperDelta traces those statements to declared experiment evidence and brings the affected locations together for review, even when no manuscript file changed. Local Python CLI · LaTeX / Markdown / Quarto + optional Word/PDF · exact decimal arithmetic · offline HTML · optional MCP. Checking needs no model key, GPU or TeX installation. A 27-second walkthrough of real reports: change experiment evidence, inspect the abstract, table and claim, then open a separate source/PDF example with a stale export. Open the full-size animation · View the static screenshot. **2.0.0** brings the declared experiment identity, exact source hashes, original context, units, records and conflicts into one Agent proposal review. Studio and the CLI share that evidence; staged agents can retract a mistaken declaration within a fixed budget. Mappings still require explicit review and confirmation. Agent evidence review · Incremental checks · Annotated-copy guide · Choose your task · Revision workbench · Notebook/Quarto workflows. Use static LaTeX, Markdown/Quarto, Word or PDF with the same declared experiment evidence and statistical contracts. Run `paperdelta studio` for local binding review, snapshots, ongoing checks and draft recovery. The interface supports English/Chinese throughout; see the Studio guide and delivery roadmap. The project has received positive informal feedback from several users; it is not presented as a measured usability study. Releases use normal version numbers. ## Install and see the first report For static source examples, use `paperdelta demo --document markdown --out md-demo --open` or `paperdelta demo --document quarto --out qmd-demo --open`. No extra or renderer is needed. For the source/PDF example, install `paperdelta[pdf]` and run `paperdelta demo --document pdf --out pdf-demo --open`. The report highlights original pages; PDF review is read-only and does not perform OCR. For a Word example, install `paperdelta[docx]` and run `paperdelta demo --document docx --out word-demo --open`. Word review is read-only; supported structures and positions are explicit. Use Python 3.11 or newer. In a virtual environment: [code] With uv installed, try `uvx --python 3.12 paperdelta@2.0.0 demo --out paperdelta-demo --open` in an isolated tool environment. Use a new output directory for each run. See optional native readers and startup diagnostics. If needed, create the environment first with `python -m venv .venv`. Activate it with `.venv\Scripts\Activate.ps1` on Windows PowerShell or `source .venv/bin/activate` on macOS/Linux (use `python3` when creating it there). The installed package includes the complete offline example. Ope