assafelovic/gpt-researcher

What is it?

Key features

• 01Generates long research reports with citations from web and local documents.
• 02Filters scraped context by relevance before sending it to the LLM.
• 03Recursive Deep Research mode explores subtopics in tree-like fashion.
• 04Connects to external data sources through an MCP client.
• 05Multi-agent workflows built on LangGraph and AG2.
• 06Exports reports to PDF, Word and other formats.

Use cases

• Producing sourced background reports on a topic from many web pages.
• Researching a private collection of PDFs, spreadsheets or notes.
• Embedding automated research into a Python application via the pip package.
• Giving an AI assistant like Claude deeper web research capabilities.

Quick start

1. 1

   Install Python 3.12 or later

2. 2

   Clone the project and enter the directory

   git clone https://github.com/assafelovic/gpt-researcher.git cd gpt-researcher
3. 3

   Set API keys as environment variables

   export OPENAI_API_KEY={Your OpenAI API Key here} export TAVILY_API_KEY={Your Tavily API Key here}
4. 4

   Install dependencies and start the server

   pip install -r requirements.txt python -m uvicorn main:app --reload

Things to know

• !Default setup needs an OpenAI API key and a Tavily API key.
• !Deep research costs about $0.4 per run and takes about 5 minutes.

Topics

FAQ

What is gpt-researcher?

An open-source autonomous research agent that plans questions, gathers web and local sources, and writes cited reports with any LLM provider. GPT Researcher is a Python agent for deep research on a given query. A planner agent breaks the task into research questions, execution agents gather and summarize sources for each one, and a publisher step aggregates the findings into a long report with citations. It can research the open web as well as local documents in PDF, Word, Excel, Markdown and other formats.

Is gpt-researcher free to use? What license does it have?

gpt-researcher is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.

Is gpt-researcher still maintained?

Actively maintained. The last commit to gpt-researcher was on Oct 10, 2026.

What can I use gpt-researcher for?

Producing sourced background reports on a topic from many web pages. Researching a private collection of PDFs, spreadsheets or notes. Embedding automated research into a Python application via the pip package. Giving an AI assistant like Claude deeper web research capabilities.

How do I install gpt-researcher?

Install Python 3.12 or later Clone the project and enter the directory: git clone https://github.com/assafelovic/gpt-researcher.git cd gpt-researcher Set API keys as environment variables: export OPENAI_API_KEY={Your OpenAI API Key here} export TAVILY_API_KEY={Your Tavily API Key here} Install dependencies and start the server: pip install -r requirements.txt python -m uvicorn main:app --reload

Where can I get gpt-researcher?

The source code and installation instructions are on GitHub: https://github.com/assafelovic/gpt-researcher