What do you want to do?
3 use cases
-
Run a deep research web app on your machine
Clone the project, set your keys and start the local server to get research reports from a browser UI.
View prompt
Set up assafelovic/gpt-researcher locally: clone it, install with `pip install -r requirements.txt`, start it with `python -m uvicorn main:app --reload`, and run a report on <my topic>.
-
Write a report from your own documents
Point GPT Researcher at a folder of PDFs, Word, Excel, PowerPoint, CSV or Markdown files and research them instead of the web.
View prompt
Using assafelovic/gpt-researcher, set `export DOC_PATH="./my-docs"` to <my folder> and produce a report on <question> using report_source local.
-
Combine web search with GitHub data via MCP
Use the pip package with the MCP retriever so research pulls from the web and from an MCP server like GitHub in one run.
View prompt
With assafelovic/gpt-researcher, run `pip install gpt-researcher`, set `export RETRIEVER=tavily,mcp`, and write a script using mcp_configs for the GitHub MCP server to research <my question about repos>.
Quick start with GPT Researcher
- Check you have what it needs: Python 3.12 or later; An OpenAI API key and a Tavily API key, or a custom OpenAI-compatible endpoint; Docker if you prefer the docker compose setup.
- Open assafelovic/gpt-researcher on GitHub and read the README and license.
- Clone with
git clone https://github.com/assafelovic/gpt-researcher.gitandcd gpt-researcher - Set your OPENAI_API_KEY and TAVILY_API_KEY as environment variables or in a .env file
- Install and start with
pip install -r requirements.txtandpython -m uvicorn main:app --reload - Open http://localhost:8000 and enter your research question
These steps come from our top use case, Run a deep research web app on your machine, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for assafelovic/gpt-researcher
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forAnalysts, students and developers who want long, sourced research reports without doing every search by hand.
- Why it is hot30k stars, talked about in 2 AI sources we track
- LanguagePython
- Sourcegithub.com/assafelovic/gpt-researcher ยท Back to Hot repos
Requirements
- Python 3.12 or later
- An OpenAI API key and a Tavily API key, or a custom OpenAI-compatible endpoint
- Docker if you prefer the docker compose setup
Add this badge to your README
Maintain GPT Researcher? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/assafelovic-gpt-researcher/?utm_source=github&utm_medium=badge&utm_campaign=assafelovic-gpt-researcher)
HTML
<a href="https://dedupedai.com/use-cases/assafelovic-gpt-researcher/?utm_source=github&utm_medium=badge&utm_campaign=assafelovic-gpt-researcher"><img src="https://dedupedai.com/badge/assafelovic/gpt-researcher.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about GPT Researcher
What is GPT Researcher?
GPT Researcher is an autonomous agent that conducts deep research on any topic with any LLM provider and writes a cited report. It runs as a web app, a pip package, a Docker stack or a Claude skill, can research your local documents, and can mix web search with MCP data sources such as GitHub. It is an open-source project on GitHub: https://github.com/assafelovic/gpt-researcher.
How do I use GPT Researcher?
Clone with git clone https://github.com/assafelovic/gpt-researcher.git and cd gpt-researcher; then set your OPENAI_API_KEY and TAVILY_API_KEY as environment variables or in a .env file; install and start with pip install -r requirements.txt and python -m uvicorn main:app --reload. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is GPT Researcher for?
Analysts, students and developers who want long, sourced research reports without doing every search by hand.
What can I do with GPT Researcher?
3 use cases so far, for example: Run a deep research web app on your machine; Write a report from your own documents; Combine web search with GitHub data via MCP. Each has steps and a copy-paste agent prompt.
What do I need to run GPT Researcher?
Python 3.12 or later; An OpenAI API key and a Tavily API key, or a custom OpenAI-compatible endpoint; Docker if you prefer the docker compose setup.
What are alternatives to GPT Researcher?
Other hot AI repos in Research: Txtai, Sam2, Graphiti, Reader, Cognee.
Is GPT Researcher safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.