← all repositories
Future-House/paper-qa

Agentic RAG that reads the footnotes first

It forces LLMs to cite page numbers when answering questions over scientific papers, PDFs, and Office documents.

paper-qa
Velocity · 7d
+6.0
★ / day
Trend
steady
star history

What it does PaperQA2 is an agentic RAG system built for scientific literature. You point it at a folder of PDFs, text files, or Microsoft Office documents, and it indexes them into a local full-text search engine. When you ask a question, an LLM agent generates keyword queries, retrieves relevant chunks, re-ranks them with contextual summaries, and synthesizes an answer complete with in-text citations and page references. It also automatically fetches metadata like citation counts, journal quality, and retraction status from providers such as Semantic Scholar and Crossref.

The interesting bit The system treats citation as a first-class constraint, not an afterthought. Its three-phase algorithm—paper search, evidence gathering with LLM-based re-scoring, and answer generation—forces the model to justify every claim with specific document excerpts. The December 2025 update even added multimodal support, passing tables, figures, and math equations through the same summarization pipeline so they can be cited like text.

Key highlights

  • Agentic workflow that iteratively refines queries and re-ranks evidence before generating an answer.
  • Embeds document metadata into vector search and enriches multimodal objects with an enrichment_llm prompt.
  • Bundled “known-good” hyperparameter presets and LiteLLM integration for swapping models or running locally.
  • Automatic metadata fetching includes citation counts, retraction checks, and journal quality data.
  • Switched to calendar versioning in December 2025, explicitly abandoning backwards-compatibility guarantees to avoid “SemVer confusion.”

Caveats

  • The authors admit they are “challenged at naming and counting” and reserve the right to rename the project arbitrarily.
  • Calendar versioning means no backwards compatibility across releases; pickled Docs objects from prior major versions are already incompatible.
  • The FAQ includes a section titled “How come I get different results than your papers?”, suggesting reproducibility can vary with model or settings.

Verdict Researchers and developers building literature-review tools or domain-specific Q&A over document collections should look here. If you just need generic chat over a few PDFs, the complexity and breaking changes are probably overkill.

Frequently asked

What is Future-House/paper-qa?
It forces LLMs to cite page numbers when answering questions over scientific papers, PDFs, and Office documents.
Is paper-qa open source?
Yes — Future-House/paper-qa is open source, released under the Apache-2.0 license.
What language is paper-qa written in?
Future-House/paper-qa is primarily written in Python.
How popular is paper-qa?
Future-House/paper-qa has 8.9k stars on GitHub and is currently holding steady.
Where can I find paper-qa?
Future-House/paper-qa is on GitHub at https://github.com/Future-House/paper-qa.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.