“An autonomous agent that conducts deep research on any data using any LLM providers” — the project's own words, on GitHub
What it does
You give it a question and it goes and researches it properly — pulling from many web sources at once, reading past what any single article says, and writing up a full report with citations you can check yourself. It's built to fix what a quick AI chat answer tends to get wrong: stale training data, invented facts, and conclusions that lean on only one or two sources. A deeper mode can also read through your own documents alongside the open web. Expect it to take a few minutes per question, since it is genuinely reading many pages before it writes a word.
Replaces
a few hours of manual web research and note-taking
For
Anyone who needs a sourced, written research report on a topic — not just a quick chat answer — and is willing to wait a few minutes for it.
Not for
Not for a quick single-fact lookup — it's built to produce a full report, not answer a one-line question fast, and it won't run at all without both an OpenAI and a Tavily key.
Setup
20 min · Claude Code, Kimi, Gemini CLI or Codex · python 3.11+, an OpenAI API key, a Tavily API key (for its web search), docker (optional, for the bundled web app)
Get it running
Paste this into the AI that runs on your computer. It does the install, checks it works, and tells you what to type first. If anything fails, paste the error back to it.
Paste into Claude Code
Install gpt-researcher (https://github.com/assafelovic/gpt-researcher) on this computer and get it working for me. I am not a developer; explain each step in one line as you go and never skip one. You are Claude Code, running on my machine.
1. Check what this machine already has (git, Python or Node as the project needs, Docker if the README says so). Tell me anything missing and install it, asking me before anything that needs my password.
2. Clone https://github.com/assafelovic/gpt-researcher into ~/tools/gpt-researcher and follow the README's install exactly.
3. Configure it. If it needs an API key or a login, stop and ask me for it; never guess one and never store it anywhere except where the README says.
Tool-specific notes: Set two environment variables before anything else — `OPENAI_API_KEY` and `TAVILY_API_KEY` — it will not run without both.
Install with `pip install gpt-researcher`, or clone the repo and run `docker compose up --build` (note: no dash — the older `docker-compose` command fails on newer setups).
Smoke-test with a short script that creates a `GPTResearcher(query=...)`, calls `conduct_research()`, then `write_report()` — or run the bundled web app and visit `http://localhost:8000`.
If you want it to read your own files too, set `DOC_PATH` to that folder before you ask your question.
Budget a few minutes per question — it is actually reading multiple pages before it writes, not returning instantly.
4. Run the smallest test the README gives, and show me the output.
5. When it works, tell me what to type first, in one line, for this job: Ask it one real question.
If anything fails, show me the exact error and fix it before going on.
Paste into Kimi
Install gpt-researcher (https://github.com/assafelovic/gpt-researcher) on this computer and get it working for me. I am not a developer; explain each step in one line as you go and never skip one. You are Kimi, running on my machine.
1. Check what this machine already has (git, Python or Node as the project needs, Docker if the README says so). Tell me anything missing and install it, asking me before anything that needs my password.
2. Clone https://github.com/assafelovic/gpt-researcher into ~/tools/gpt-researcher and follow the README's install exactly.
3. Configure it. If it needs an API key or a login, stop and ask me for it; never guess one and never store it anywhere except where the README says.
Tool-specific notes: Set two environment variables before anything else — `OPENAI_API_KEY` and `TAVILY_API_KEY` — it will not run without both.
Install with `pip install gpt-researcher`, or clone the repo and run `docker compose up --build` (note: no dash — the older `docker-compose` command fails on newer setups).
Smoke-test with a short script that creates a `GPTResearcher(query=...)`, calls `conduct_research()`, then `write_report()` — or run the bundled web app and visit `http://localhost:8000`.
If you want it to read your own files too, set `DOC_PATH` to that folder before you ask your question.
Budget a few minutes per question — it is actually reading multiple pages before it writes, not returning instantly.
4. Run the smallest test the README gives, and show me the output.
5. When it works, tell me what to type first, in one line, for this job: Ask it one real question.
If anything fails, show me the exact error and fix it before going on.
Paste into Gemini CLI
Install gpt-researcher (https://github.com/assafelovic/gpt-researcher) on this computer and get it working for me. I am not a developer; explain each step in one line as you go and never skip one. You are Gemini CLI, running on my machine.
1. Check what this machine already has (git, Python or Node as the project needs, Docker if the README says so). Tell me anything missing and install it, asking me before anything that needs my password.
2. Clone https://github.com/assafelovic/gpt-researcher into ~/tools/gpt-researcher and follow the README's install exactly.
3. Configure it. If it needs an API key or a login, stop and ask me for it; never guess one and never store it anywhere except where the README says.
Tool-specific notes: Set two environment variables before anything else — `OPENAI_API_KEY` and `TAVILY_API_KEY` — it will not run without both.
Install with `pip install gpt-researcher`, or clone the repo and run `docker compose up --build` (note: no dash — the older `docker-compose` command fails on newer setups).
Smoke-test with a short script that creates a `GPTResearcher(query=...)`, calls `conduct_research()`, then `write_report()` — or run the bundled web app and visit `http://localhost:8000`.
If you want it to read your own files too, set `DOC_PATH` to that folder before you ask your question.
Budget a few minutes per question — it is actually reading multiple pages before it writes, not returning instantly.
4. Run the smallest test the README gives, and show me the output.
5. When it works, tell me what to type first, in one line, for this job: Ask it one real question.
If anything fails, show me the exact error and fix it before going on.
Paste into Codex
Install gpt-researcher (https://github.com/assafelovic/gpt-researcher) on this computer and get it working for me. I am not a developer; explain each step in one line as you go and never skip one. You are Codex, running on my machine.
1. Check what this machine already has (git, Python or Node as the project needs, Docker if the README says so). Tell me anything missing and install it, asking me before anything that needs my password.
2. Clone https://github.com/assafelovic/gpt-researcher into ~/tools/gpt-researcher and follow the README's install exactly.
3. Configure it. If it needs an API key or a login, stop and ask me for it; never guess one and never store it anywhere except where the README says.
Tool-specific notes: Set two environment variables before anything else — `OPENAI_API_KEY` and `TAVILY_API_KEY` — it will not run without both.
Install with `pip install gpt-researcher`, or clone the repo and run `docker compose up --build` (note: no dash — the older `docker-compose` command fails on newer setups).
Smoke-test with a short script that creates a `GPTResearcher(query=...)`, calls `conduct_research()`, then `write_report()` — or run the bundled web app and visit `http://localhost:8000`.
If you want it to read your own files too, set `DOC_PATH` to that folder before you ask your question.
Budget a few minutes per question — it is actually reading multiple pages before it writes, not returning instantly.
4. Run the smallest test the README gives, and show me the output.
5. When it works, tell me what to type first, in one line, for this job: Ask it one real question.
If anything fails, show me the exact error and fix it before going on.
What to point it at first
1
Ask it one real question
Give it a specific question you'd actually want answered — not a topic — and check the report cites a source for every claim you'd want to challenge.
2
Check the sources, not just the report
Open two or three of the links it cites and confirm they actually say what the report claims, since it aggregates sources rather than verifying every sentence in them.
3
Point it at your own documents
Set its local-documents folder to a set of your own files and ask a similar question, so you can see it blend your material with the open web rather than only the web.
What it must never do unattended
Never publish what it found without opening the sources yourself.
Never point it past a login or a CAPTCHA. Public pages only, and it respects robots.txt.
Who made it
assafelovic/gpt-researcher on GitHub, under the Apache-2.0 licence. 29,365 stars, checked 9 September 2026. Last change 23 August 2026. We did not write it; we checked it, and wrote this page so you can use it.