amos689 / paper-preflight

**Check every reference of a paper against real scholarly records before you submit. 
No LLM guessing, no false accusations.**
**English** · 简体中文 · Quick start ·
User guide · Releases ·
Feedback
Language models invent references, and copy-pasted BibTeX carries wrong years, wrong authors
and dead DOIs. paper-preflight reads your paper (LaTeX, Word, Markdown, Typst, a PDF or a plain
reference list) and asks Crossref, dblp, arXiv, DataCite, PubMed and OpenAlex about every cited
work, with Semantic Scholar too if you have a free key, Open Library for books without a DOI,
and GitHub, PyPI, CRAN, Hugging Face and OpenML for software, models and datasets:
- Does it exist?
- Does it match what you wrote?
- Has it been retracted?
- Has the preprint you cite been published since?
Every finding is backed by a record, or by every source that could know the work answering
"no". When it cannot tell, it says "cannot determine" and why, instead of guessing. No language
model takes part in a verdict.
> **Status: 1.0.** On three weeks of real arXiv papers held out for the release: 0.79 false
> alarms per 100 references, against 409 real problems found (accuracy).
> Rule IDs, the JSON report, settings, commands and the Python API are kept through 1.x
> (what is stable). False positives are the bugs we most want to hear
> about: please open an issue.
## Quick start
With uv nothing needs installing:
 [code] 
`path/to/paper` is the project's folder, its main `.tex` file or a `.bib` file. To install it
for good (Python 3.11 or later):
 [code] 
| Extra | Adds | Install |
|---|---|---|
| `pdf` | Reading the reference list of a PDF | `pip install "paper-preflight[pdf]"` |
| `mcp` | The MCP server for coding agents | `pip install "paper-preflight[mcp]"` |
| `support` | The experimental evidence finder, with its local model | `pip install "paper-preflight[support]"` |
The repository's demo paper cites eleven works, several of them wrong on
purpose. The animation above is a real run of `paper-preflight check examples/demo-paper`
against the live sources. In it, the correct NeurIPS paper is verified through dblp although
Crossref only holds fake copies of it, the book without an identifier is confirmed by Open
Library, and the Chinese book, whose script is not supported yet, is "cannot determine", not
"not found".
 The same run as text 
 [code] 
## What it reads
| You have | Command |
|---|---|
| A LaTeX project: its folder, main `.tex` or `.bib`; a project that ships only its compiled `.bbl`, as many arXiv sources do, is read from it (checked, never edited) | `paper-preflight check path/to/paper` |
| A Word manuscript: citations inserted by Zotero, Mendeley or EndNote, Word's own sources, or the reference list as typed | `paper-preflight check paper.docx` |
| Markdown, Quarto or R Markdown: `[@key]` against its bibliography | `paper-preflight check paper.qmd` |
| Typst: `@key` against `#bibliography(...)`, a `.bib` or Hayagriva `.yml` | `paper-preflight check paper.typ` |
|