{
 "schema_version": 1,
 "generated": "2026-11-01",
 "id": "assafelovic-gpt-researcher--run-a-deep-research-web-app-with-gpt-researcher",
 "repo": "assafelovic/gpt-researcher",
 "repo_url": "https://github.com/assafelovic/gpt-researcher",
 "repo_slug": "assafelovic-gpt-researcher",
 "title": "Run a deep research web app on your machine",
 "page_title": "How to run a deep research web app on your machine with GPT Researcher",
 "summary": "Clone the project, set your keys and start the local server to get research reports from a browser UI.",
 "who": "Anyone who wants a research report on a topic in minutes.",
 "problem": "Reading dozens of sources by hand for one question takes hours.",
 "outcome": "A local web app at localhost:8000 that writes research reports.",
 "steps": [
  "Clone with `git clone https://github.com/assafelovic/gpt-researcher.git` and `cd 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.txt` and `python -m uvicorn main:app --reload`",
  "Open http://localhost:8000 and enter your research question"
 ],
 "agent_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>.",
 "agents": [
  "claude-code",
  "codex",
  "cursor",
  "gemini-cli"
 ],
 "difficulty": "Beginner",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "Reports summarize web sources automatically, so verify key claims against the cited sources before relying on them.",
 "category": "Research",
 "tags": [
  "Research"
 ],
 "lang": "python",
 "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"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "cost",
   "notice": "Each report makes many LLM and search API calls billed to your OpenAI and Tavily accounts."
  }
 ],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/assafelovic-gpt-researcher/run-a-deep-research-web-app-with-gpt-researcher/",
 "md": "https://dedupedai.com/use-cases/assafelovic-gpt-researcher/run-a-deep-research-web-app-with-gpt-researcher/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/assafelovic-gpt-researcher--run-a-deep-research-web-app-with-gpt-researcher.json",
 "api_version": "v1"
}