Verbatim Citation Gate

verbatim-citation-gate

[](https://github.com/tonydzi/verbatim-citation-gate/actions/workflows/tests.yml) [](https://github.com/tonydzi/verbatim-citation-gate/blob/master/pyproject.toml) [](LICENSE) [](https://tonydzi.github.io/verbatim-citation-gate/)

**Catch fabricated RAG citations before they reach the user.** A two-stage, framework-agnostic auditor for quote-style citations. The deterministic half is `src/verbatim_citation_gate/gate.py`: zero dependencies, zero tokens. The model half is `src/verbatim_citation_gate/judge.py`, and plugs into whatever LLM your pipeline already speaks.


Quickstart — 30 seconds, no API key

pip install "git+https://github.com/tonydzi/verbatim-citation-gate"

from verbatim_citation_gate import quote_gate

docs = {"veltranib-rct": "... Body weight was unchanged in both arms."}

quote_gate("Body weight was unchanged in both arms.", "veltranib-rct", docs)  # 'found'
quote_gate("Veltranib produced dramatic weight loss.", "veltranib-rct", docs)  # 'not_found'

That is stage 1, and it is the whole offline half: no key, no network, no tokens. The run in the animation above is [`examples/demo.py`](examples/demo.py) — `python examples/demo.py` reproduces it, model calls counted by the demo itself. Stage 2 (the judge) needs a model and is one argument away — see [Use](#use) below.

📖 **Docs: ** — the two stages, the API, the verdicts, and every known limit with its issue.

RAG systems love to cite. The prob