LibreAI / AI Agents / gpt-researcher
// agents · assafelovic/gpt-researcher

gpt-researcher

An autonomous research agent that plans, searches and writes cited reports from any data source

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

Project facts

gpt-researcher is an open-source ai agents project by assafelovic (assafelovic/gpt-researcher on GitHub). It has 29,955 GitHub stars and 4,095 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 1 October 2026.

GitHub stars
29,955
Forks
4,095
License
Apache-2.0
Last updated on GitHub
1 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide what you want to achieve with gpt-researcher and check the README on GitHub for requirements before installing.

  2. Get the code

    Clone the repository from GitHub (or take the packaged install route in step 3 if the README offers one).

  3. Install and configure

    Follow the project's documented install commands — the Run section below lists the exact ones — and add any required API keys or models.

  4. Run your first task

    Work through the README's quickstart example end to end, then adapt it to your own project or data.

// features

Why people love it

Autonomous research plans

The agent breaks a question into sub-queries, searches them in parallel and synthesizes a report.

Cited, aggregated reports

Output reports aggregate multiple sources with citations rather than a single model's memory.

Deep Research mode

A dedicated deep-research flow spends more time exploring for complex questions.

Local document research

Point it at your own PDFs/documents to research private material, not just the web.

Any LLM provider

Works across LLM providers — configure the models you already have keys for.

MCP server and Claude Skill

Can run as an MCP server for agent hosts, and installs as a Claude Skill via npx skills.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the GPT Researcher source and examples.

    git clone https://github.com/assafelovic/gpt-researcher.git
    cd gpt-researcher
  2. Install dependencies

    Install the requirements (or simply pip install gpt-researcher for library use), then set your LLM and search API keys in .env.

    pip install -r requirements.txt
    # library alternative: pip install gpt-researcher
  3. Run your first research task

    Start the app (or the Python example from the README), give it a research question and read the generated report.

    # see the README 'Example Usage' for the exact Python snippet
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains gpt-researcher?

gpt-researcher is maintained by the assafelovic organization/account on GitHub, together with open-source contributors, in the public repository assafelovic/gpt-researcher.

Is gpt-researcher free to use?

Yes — the code is open source under the Apache-2.0 license. You can use, modify and redistribute it under that license's terms.

Does gpt-researcher need a paid API key?

Yes — you need your own LLM API key and a web-search API key for the search provider you configure (Tavily is the common choice); the software itself is free and Apache-2.0 licensed.

How does gpt-researcher compare to ChatGPT Deep Research / Perplexity?

Hosted deep-research tools are convenient but closed; GPT Researcher is self-hostable, provider-agnostic and scriptable, at the cost of your own keys and setup.

How do I get started with gpt-researcher?

Clone the repository from GitHub, follow the install commands in the Run section (taken from the project's README), and complete the documented quickstart example before adapting it to your own use case.

// keep exploring

Similar tools

AI Agents

deep-research

Deep Research with any LLM: in-depth reports in minutes, with an SSE API and MCP server built in

★ 4.7k starsMIT
View guide →
AI Agents

RD-Agent

Microsoft's R&D-Agent: LLM agents that automate data-driven research, Kaggle modelling and LLM fine-tuning.

★ 14.9k starsMIT
View guide →
AI Agents

firecrawl

Turn any website into clean, agent-ready data with one API.

★ 189.6k starsAGPL-3.0
View guide →
Agents

llm-wiki

Parallel multi-agent research that compiles wikis from any topic.

★ 1.4k starsMIT
View guide →
AI Agents

Agon

Autonomous research loops, from topic to experiments.

★ 54 starsMIT
View guide →
AI Agents

OpenScience

OpenScience — the open-source AI workbench for scientific research: give it a goal, it reads the literature, runs the experiments and writes up the findings

★ 4.0k starsApache-2.0
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if gpt-researcher is not the right fit.

Get gpt-researcher

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