{"name":"DeerFlow: A Deep Research Framework Powered by LLMs and Multi-Agent Systems","description":"DeerFlow is a community-driven Deep Research framework developed by ByteDance, designed to combine language models with powerful tools for web search, crawling, and Python execution. It enables comprehensive research processes, from intelligent clarification to report generation and even podcast creation, all while giving back to the open-source community.","github":"https://github.com/bytedance/deer-flow","url":"https://osrepos.com/repo/bytedance-deer-flow","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/bytedance-deer-flow","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/bytedance-deer-flow.md","json":"https://osrepos.com/repo/bytedance-deer-flow.json","topics":["agent","ai","llm","deep-research","multi-agent","langchain","langgraph","Python"],"keywords":["agent","ai","llm","deep-research","multi-agent","langchain","langgraph","Python"],"stars":null,"summary":"DeerFlow is a community-driven Deep Research framework developed by ByteDance, designed to combine language models with powerful tools for web search, crawling, and Python execution. It enables comprehensive research processes, from intelligent clarification to report generation and even podcast creation, all while giving back to the open-source community.","content":"## Introduction\n\nDeerFlow, developed by ByteDance, is a robust, community-driven Deep Research framework that leverages the power of language models alongside specialized tools for comprehensive information gathering and analysis. It integrates capabilities such as web search, crawling, and Python code execution to facilitate in-depth research processes. The framework is built on a modular multi-agent system architecture using LangGraph, designed for automated research and code analysis, and aims to contribute significantly back to the open-source community.\n\n## Installation\n\nGetting started with DeerFlow involves a few straightforward steps. The project is primarily developed in Python and includes a web UI built with Node.js.\n\n**Recommended Tools:**\n*   **`uv`**: For simplified Python environment and dependency management.\n*   **`nvm`**: To manage multiple Node.js runtime versions.\n*   **`pnpm`**: For installing and managing Node.js project dependencies.\n\n**Environment Requirements:**\n*   Python: Version `3.12+`\n*   Node.js: Version `22+`\n\n**Quick Start Commands:**\n\nbash\n# Clone the repository\ngit clone https://github.com/bytedance/deer-flow.git\ncd deer-flow\n\n# Install Python dependencies (uv handles venv creation)\nuv sync\n\n# Configure .env with your API keys (e.g., Tavily, Brave Search)\ncp .env.example .env\n\n# Configure conf.yaml for your LLM model and API keys\ncp conf.yaml.example conf.yaml\n\n# Optionally, install web UI dependencies\ncd deer-flow/web\npnpm install\n\n\nFor detailed configuration, refer to the `docs/configuration_guide.md` within the repository.\n\n## Examples\n\nDeerFlow offers various examples demonstrating its capabilities in generating comprehensive research reports and interactive sessions.\n\n**Demo Replays:**\n*   [How tall is Eiffel Tower compared to tallest building?](https://deerflow.tech/chat?replay=eiffel-tower-vs-tallest-building)\n*   [What are the top trending repositories on GitHub?](https://deerflow.tech/chat?replay=github-top-trending-repo)\n*   [Write an article about Nanjing's traditional dishes](https://deerflow.tech/chat?replay=nanjing-traditional-dishes)\n\n**Research Reports (examples from the repository):**\n*   OpenAI Sora Report\n*   Google's Agent to Agent Protocol Report\n*   What is LLM?\n*   AI Adoption in Healthcare: Influencing Factors\n\nYou can run these examples or create your own research reports using the command line:\n\nbash\n# Run with a specific query\nuv run main.py \"What factors are influencing AI adoption in healthcare?\"\n\n# Run in interactive mode\nuv run main.py --interactive\n\n\n## Why Use DeerFlow?\n\nDeerFlow stands out as a powerful framework for anyone engaged in deep research, offering a suite of features designed to enhance efficiency and accuracy:\n\n*   **Advanced LLM Integration**: Supports most models via `litellm` and open-source models, providing a multi-tier LLM system.\n*   **Comprehensive Tooling**: Integrates web search (Tavily, Brave Search, DuckDuckGo), crawling, and private knowledge bases (RAGFlow, Qdrant, Milvus).\n*   **Human-in-the-Loop Collaboration**: Features intelligent clarification, interactive modification of research plans, and post-editing capabilities for reports.\n*   **Content Creation**: Automates podcast script generation, audio synthesis, and simple PowerPoint presentations from research reports.\n*   **Modular Architecture**: Built on LangGraph, it uses a multi-agent system (Coordinator, Planner, Research Team, Reporter) for flexible and scalable workflows.\n\n## Links\n\n*   **GitHub Repository**: [https://github.com/bytedance/deer-flow](https://github.com/bytedance/deer-flow)\n*   **Official Website**: [https://deerflow.tech/](https://deerflow.tech/)\n*   **Volcengine Experience**: [https://console.volcengine.com/vefaas/region:vefaas+cn-beijing/market/deerflow/?channel=github&source=deerflow](https://console.volcengine.com/vefaas/region:vefaas+cn-beijing/market/deerflow/?channel=github&source=deerflow)\n*   **Volcengine Deployment**: [https://console.volcengine.com/vefaas/region:vefaas+cn-beijing/application/create?templateId=683adf9e372daa0008aaed5c&channel=github&source=deerflow](https://console.volcengine.com/vefaas/region:vefaas+cn-beijing/application/create?templateId=683adf9e372daa0008aaed5c&channel=github&source=deerflow)","metrics":{"detailViews":5,"githubClicks":4},"dates":{"published":null,"modified":"2025-11-24T16:00:46.000Z"}}