// rag · Future-House/paper-qa

paper-qa

PaperQA2 — high-accuracy RAG for answering questions from scientific papers, with citations you can check.

★ 9.3k stars⑂ 934 forksApache-2.0updated 2026-09
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

paper-qa is an open-source rag & knowledge project by Future-House (Future-House/paper-qa on GitHub). It has 9,329 GitHub stars and 934 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 25 September 2026.

GitHub stars
9,329
Forks
934
License
Apache-2.0
Last updated on GitHub
25 September 2026
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Gather the papers or documents you want to question (PDF, text, Markdown, HTML, Office and code files are supported) and choose your LLM and embedding model.

  2. Get the project

    Clone Future-House/paper-qa from GitHub (or use the install path in the run steps below) and skim its README for the parts relevant to your goal.

  3. Install and configure

    Install paper-qa from PyPI — add the local extra if you want a local embedding model instead of a hosted one.

  4. Run your first task

    Add a small set of documents to a Docs object, ask one question you know the answer to, and verify the cited sources support it.

// features

Why people love it

Built for scientific documents

Designed specifically for answering questions from scientific literature with high accuracy, rather than generic chat over files.

Citations included

Answers come with citations to the source documents, so claims can be checked against the papers.

Agentic document handling

The library can add and query documents agentically, or you can drive the Docs object manually for full control.

Library and CLI

Use it as a Python library (sync or async) or from the bundled CLI, with bundled settings presets.

Model choice

Configure the answering model and the embedding model separately, including a local embedding option via paper-qa[local].

Adjustable sourcing

Tune how many sources are retrieved per question to balance answer depth against cost and latency.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source from the official GitHub repository for paper-qa.

    git clone https://github.com/Future-House/paper-qa.git
    cd paper-qa
  2. Install PaperQA

    Install the package from PyPI as the README's installation section shows.

    pip install paper-qa
  3. Add documents and query

    Use the library quickstart pattern from the README: build a Docs object, add your papers, then query it.

    # In Python: from paperqa import Docs; docs = Docs(); await docs.aadd('paper.pdf'); answer = await docs.aquery('Your question?')  # see README
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains paper-qa?

Future-House, through the Future-House/paper-qa repository, with a cookbook at futurehouse.gitbook.io.

Is paper-qa free to use?

Yes — the project is open source under the Apache-2.0 license as recorded for this listing. See the license terms for any conditions on redistribution.

Does paper-qa need a paid API key?

By default it uses hosted LLM and embedding models, so you need your own API keys; a local embedding model is available via the paper-qa[local] extra.

How does PaperQA compare to a general-purpose RAG framework?

General frameworks give you chunking and vector search to assemble yourself. PaperQA is an opinionated, science-focused system — agentic retrieval over papers and cited answers out of the box — which is faster to use for literature Q&A but less of a blank canvas.

How do I get started with paper-qa?

Clone the repository (or use the documented installer), follow the install and configure steps on this page, and run the smallest real task first — add a small set of documents to a Docs object, ask one question you know the answer to, and verify the cited sources support it.

// keep exploring

Similar tools

RAG & Knowledge

autonomie

Open rag & knowledge for "autonomie" is a highly semantic, responsive, accessibl.

★ 103 starsMIT
View guide →
RAG & Knowledge

PageIndex

PageIndex: vectorless, reasoning-based RAG that indexes documents like a human expert would

★ 39.0k starsMIT
View guide →
RAG & Knowledge

SQLBot

SQLBot — DataEase's conversational analytics: ask in natural language, get SQL answers via LLMs plus RAG.

★ 6.9k starsGPL-3.0
View guide →
RAG & Knowledge

ragent

Ragent (容纳智能体): a production-grade Java Agentic RAG platform with hybrid retrieval and an admin console

★ 4.2k starsApache-2.0
View guide →
RAG & Knowledge

coco-server

Free rag & knowledge tool that 🥥 coco ai server - search, connect, collaborate, ai-pow.

★ 147 starsNOASSERTION
View guide →
// alternatives

Alternatives in RAG & Knowledge

The most-starred other RAG & Knowledge projects in the LibreAI catalogue — the realistic shortlist if paper-qa is not the right fit.

Get paper-qa

Free and open — grab the source, star the repo, and start creating.