[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-71943":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":18,"compositeScore":19,"rankGlobal":8,"rankLanguage":8,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":8,"pushedAt":8,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":14,"starSnapshotCount":14,"syncStatus":28,"lastSyncTime":29,"discoverSource":30},71943,"open_deep_research","langchain-ai\u002Fopen_deep_research","langchain-ai",null,"Python",11656,1665,72,35,0,43,117,286,129,44.67,"MIT License",false,"main",true,[],"2026-06-12 02:02:56","# 🔬 Open Deep Research\n\n\u003Cimg width=\"1388\" height=\"298\" alt=\"full_diagram\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F12a2371b-8be2-4219-9b48-90503eb43c69\" \u002F>\n\nDeep research has broken out as one of the most popular agent applications. This is a simple, configurable, fully open source deep research agent that works across many model providers, search tools, and MCP servers. It's performance is on par with many popular deep research agents ([see Deep Research Bench leaderboard](https:\u002F\u002Fhuggingface.co\u002Fspaces\u002FAyanami0730\u002FDeepResearch-Leaderboard)).\n\n\u003Cimg width=\"817\" height=\"666\" alt=\"Screenshot 2025-07-13 at 11 21 12 PM\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F052f2ed3-c664-4a4f-8ec2-074349dcaa3f\" \u002F>\n\n### 🔥 Recent Updates\n\n**August 14, 2025**: See our free course [here](https:\u002F\u002Facademy.langchain.com\u002Fcourses\u002Fdeep-research-with-langgraph) (and course repo [here](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Fdeep_research_from_scratch)) on building open deep research.\n\n**August 7, 2025**: Added GPT-5 and updated the Deep Research Bench evaluation w\u002F GPT-5 results.\n\n**August 2, 2025**: Achieved #6 ranking on the [Deep Research Bench Leaderboard](https:\u002F\u002Fhuggingface.co\u002Fspaces\u002FAyanami0730\u002FDeepResearch-Leaderboard) with an overall score of 0.4344. \n\n**July 30, 2025**: Read about the evolution from our original implementations to the current version in our [blog post](https:\u002F\u002Frlancemartin.github.io\u002F2025\u002F07\u002F30\u002Fbitter_lesson\u002F).\n\n**July 16, 2025**: Read more in our [blog](https:\u002F\u002Fblog.langchain.com\u002Fopen-deep-research\u002F) and watch our [video](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=agGiWUpxkhg) for a quick overview.\n\n### 🚀 Quickstart\n\n1. Clone the repository and activate a virtual environment:\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Fopen_deep_research.git\ncd open_deep_research\nuv venv\nsource .venv\u002Fbin\u002Factivate  # On Windows: .venv\\Scripts\\activate\n```\n\n2. Install dependencies:\n```bash\nuv sync\n# or\nuv pip install -r pyproject.toml\n```\n\n3. Set up your `.env` file to customize the environment variables (for model selection, search tools, and other configuration settings):\n```bash\ncp .env.example .env\n```\n\n4. Launch agent with the LangGraph server locally:\n\n```bash\n# Install dependencies and start the LangGraph server\nuvx --refresh --from \"langgraph-cli[inmem]\" --with-editable . --python 3.11 langgraph dev --allow-blocking\n```\n\nThis will open the LangGraph Studio UI in your browser.\n\n```\n- 🚀 API: http:\u002F\u002F127.0.0.1:2024\n- 🎨 Studio UI: https:\u002F\u002Fsmith.langchain.com\u002Fstudio\u002F?baseUrl=http:\u002F\u002F127.0.0.1:2024\n- 📚 API Docs: http:\u002F\u002F127.0.0.1:2024\u002Fdocs\n```\n\nAsk a question in the `messages` input field and click `Submit`. Select different configuration in the \"Manage Assistants\" tab.\n\n### ⚙️ Configurations\n\n#### LLM :brain:\n\nOpen Deep Research supports a wide range of LLM providers via the [init_chat_model() API](https:\u002F\u002Fpython.langchain.com\u002Fdocs\u002Fhow_to\u002Fchat_models_universal_init\u002F). It uses LLMs for a few different tasks. See the below model fields in the [configuration.py](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Fopen_deep_research\u002Fblob\u002Fmain\u002Fsrc\u002Fopen_deep_research\u002Fconfiguration.py) file for more details. This can be accessed via the LangGraph Studio UI. \n\n- **Summarization** (default: `openai:gpt-4.1-mini`): Summarizes search API results\n- **Research** (default: `openai:gpt-4.1`): Power the search agent\n- **Compression** (default: `openai:gpt-4.1`): Compresses research findings\n- **Final Report Model** (default: `openai:gpt-4.1`): Write the final report\n\n> Note: the selected model will need to support [structured outputs](https:\u002F\u002Fpython.langchain.com\u002Fdocs\u002Fintegrations\u002Fchat\u002F) and [tool calling](https:\u002F\u002Fpython.langchain.com\u002Fdocs\u002Fhow_to\u002Ftool_calling\u002F).\n\n> Note: For OpenRouter: Follow [this guide](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Fopen_deep_research\u002Fissues\u002F75#issuecomment-2811472408) and for local models via Ollama  see [setup instructions](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Fopen_deep_research\u002Fissues\u002F65#issuecomment-2743586318).\n\n#### Search API :mag:\n\nOpen Deep Research supports a wide range of search tools. By default it uses the [Tavily](https:\u002F\u002Fwww.tavily.com\u002F) search API. Has full MCP compatibility and work native web search for Anthropic and OpenAI. See the `search_api` and `mcp_config` fields in the [configuration.py](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Fopen_deep_research\u002Fblob\u002Fmain\u002Fsrc\u002Fopen_deep_research\u002Fconfiguration.py) file for more details. This can be accessed via the LangGraph Studio UI. \n\n#### Other \n\nSee the fields in the [configuration.py](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Fopen_deep_research\u002Fblob\u002Fmain\u002Fsrc\u002Fopen_deep_research\u002Fconfiguration.py) for various other settings to customize the behavior of Open Deep Research. \n\n### 📊 Evaluation\n\nOpen Deep Research is configured for evaluation with [Deep Research Bench](https:\u002F\u002Fhuggingface.co\u002Fspaces\u002FAyanami0730\u002FDeepResearch-Leaderboard). This benchmark has 100 PhD-level research tasks (50 English, 50 Chinese), crafted by domain experts across 22 fields (e.g., Science & Tech, Business & Finance) to mirror real-world deep-research needs. It has 2 evaluation metrics, but the leaderboard is based on the RACE score. This uses LLM-as-a-judge (Gemini) to evaluate research reports against a golden set of reports compiled by experts across a set of metrics.\n\n#### Usage\n\n> Warning: Running across the 100 examples can cost ~$20-$100 depending on the model selection.\n\nThe dataset is available on [LangSmith via this link](https:\u002F\u002Fsmith.langchain.com\u002Fpublic\u002Fc5e7a6ad-fdba-478c-88e6-3a388459ce8b\u002Fd). To kick off evaluation, run the following command:\n\n```bash\n# Run comprehensive evaluation on LangSmith datasets\npython tests\u002Frun_evaluate.py\n```\n\nThis will provide a link to a LangSmith experiment, which will have a name `YOUR_EXPERIMENT_NAME`. Once this is done, extract the results to a JSONL file that can be submitted to the Deep Research Bench.\n\n```bash\npython tests\u002Fextract_langsmith_data.py --project-name \"YOUR_EXPERIMENT_NAME\" --model-name \"you-model-name\" --dataset-name \"deep_research_bench\"\n```\n\nThis creates `tests\u002Fexpt_results\u002Fdeep_research_bench_model-name.jsonl` with the required format. Move the generated JSONL file to a local clone of the Deep Research Bench repository and follow their [Quick Start guide](https:\u002F\u002Fgithub.com\u002FAyanami0730\u002Fdeep_research_bench?tab=readme-ov-file#quick-start) for evaluation submission.\n\n#### Results \n\n| Name | Commit | Summarization | Research | Compression | Total Cost | Total Tokens | RACE Score | Experiment |\n|------|--------|---------------|----------|-------------|------------|--------------|------------|------------|\n| GPT-5 | [ca3951d](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Fopen_deep_research\u002Fpull\u002F168\u002Fcommits) | openai:gpt-4.1-mini | openai:gpt-5 | openai:gpt-4.1 |  | 204,640,896 | 0.4943 | [Link](https:\u002F\u002Fsmith.langchain.com\u002Fo\u002Febbaf2eb-769b-4505-aca2-d11de10372a4\u002Fdatasets\u002F6e4766ca-613c-4bda-8bde-f64f0422bbf3\u002Fcompare?selectedSessions=4d5941c8-69ce-4f3d-8b3e-e3c99dfbd4cc&baseline=undefined) |\n| Defaults | [6532a41](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Fopen_deep_research\u002Fcommit\u002F6532a4176a93cc9bb2102b3d825dcefa560c85d9) | openai:gpt-4.1-mini | openai:gpt-4.1 | openai:gpt-4.1 | $45.98 | 58,015,332 | 0.4309 | [Link](https:\u002F\u002Fsmith.langchain.com\u002Fo\u002Febbaf2eb-769b-4505-aca2-d11de10372a4\u002Fdatasets\u002F6e4766ca-6[…]ons=cf4355d7-6347-47e2-a774-484f290e79bc&baseline=undefined) |\n| Claude Sonnet 4 | [f877ea9](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Fopen_deep_research\u002Fpull\u002F163\u002Fcommits\u002Ff877ea93641680879c420ea991e998b47aab9bcc) | openai:gpt-4.1-mini | anthropic:claude-sonnet-4-20250514 | openai:gpt-4.1 | $187.09 | 138,917,050 | 0.4401 | [Link](https:\u002F\u002Fsmith.langchain.com\u002Fo\u002Febbaf2eb-769b-4505-aca2-d11de10372a4\u002Fdatasets\u002F6e4766ca-6[…]ons=04f6002d-6080-4759-bcf5-9a52e57449ea&baseline=undefined) |\n| Deep Research Bench Submission | [c0a160b](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Fopen_deep_research\u002Fcommit\u002Fc0a160b57a9b5ecd4b8217c3811a14d8eff97f72) | openai:gpt-4.1-nano | openai:gpt-4.1 | openai:gpt-4.1 | $87.83 | 207,005,549 | 0.4344 | [Link](https:\u002F\u002Fsmith.langchain.com\u002Fo\u002Febbaf2eb-769b-4505-aca2-d11de10372a4\u002Fdatasets\u002F6e4766ca-6[…]ons=e6647f74-ad2f-4cb9-887e-acb38b5f73c0&baseline=undefined) |\n\n### 🚀 Deployments and Usage\n\n#### LangGraph Studio\n\nFollow the [quickstart](#-quickstart) to start LangGraph server locally and test the agent out on LangGraph Studio.\n\n#### Hosted deployment\n \nYou can easily deploy to [LangGraph Platform](https:\u002F\u002Flangchain-ai.github.io\u002Flanggraph\u002Fconcepts\u002F#deployment-options). \n\n#### Open Agent Platform\n\nOpen Agent Platform (OAP) is a UI from which non-technical users can build and configure their own agents. OAP is great for allowing users to configure the Deep Researcher with different MCP tools and search APIs that are best suited to their needs and the problems that they want to solve.\n\nWe've deployed Open Deep Research to our public demo instance of OAP. All you need to do is add your API Keys, and you can test out the Deep Researcher for yourself! Try it out [here](https:\u002F\u002Foap.langchain.com)\n\nYou can also deploy your own instance of OAP, and make your own custom agents (like Deep Researcher) available on it to your users.\n1. [Deploy Open Agent Platform](https:\u002F\u002Fdocs.oap.langchain.com\u002Fquickstart)\n2. [Add Deep Researcher to OAP](https:\u002F\u002Fdocs.oap.langchain.com\u002Fsetup\u002Fagents)\n\n### Legacy Implementations 🏛️\n\nThe `src\u002Flegacy\u002F` folder contains two earlier implementations that provide alternative approaches to automated research. They are less performant than the current implementation, but provide alternative ideas understanding the different approaches to deep research.\n\n#### 1. Workflow Implementation (`legacy\u002Fgraph.py`)\n- **Plan-and-Execute**: Structured workflow with human-in-the-loop planning\n- **Sequential Processing**: Creates sections one by one with reflection\n- **Interactive Control**: Allows feedback and approval of report plans\n- **Quality Focused**: Emphasizes accuracy through iterative refinement\n\n#### 2. Multi-Agent Implementation (`legacy\u002Fmulti_agent.py`)  \n- **Supervisor-Researcher Architecture**: Coordinated multi-agent system\n- **Parallel Processing**: Multiple researchers work simultaneously\n- **Speed Optimized**: Faster report generation through concurrency\n- **MCP Support**: Extensive Model Context Protocol integration\n","Open Deep Research 是一个用于深度研究的开源代理工具，支持多种模型提供商、搜索工具和MCP服务器。项目采用Python编写，核心功能包括高度可配置的研究代理设置，能够跨多个平台运行，并且性能与许多流行的深度研究代理相当。技术特点上，它通过init_chat_model() API支持广泛的大型语言模型（LLM），并为用户提供了一个易于使用的界面来管理这些模型。此项目适用于需要进行复杂信息检索与分析的场景，如学术研究、市场分析等，同时也为开发者提供了一个强大的框架以构建自定义的深度研究应用。",2,"2026-06-11 03:39:34","high_star"]