zilliztech/deep-searcher

这是什么？

核心功能

• 01对私有文档进行多步检索、评估与推理。
• 02支持 Milvus、Zilliz Cloud、Qdrant 等向量数据库。
• 03兼容 OpenAI、DeepSeek、Claude、Gemini、Ollama 等多家大模型服务。
• 04可加载本地 PDF、文本和 Markdown 文件，并通过 FireCrawl、Crawl4AI 等爬虫导入网页。
• 05提供 Python 接口、命令行工具和 FastAPI 网页服务。

适用场景

• 为企业内部文档搭建问答助手，数据留在自有环境中。
• 基于一批 PDF 和笔记自动生成研究类报告。
• 通过 Ollama 使用本地模型，在离线环境中检索知识库。
• 快速验证检索增强生成（RAG）方案，并灵活替换大模型和 Embedding 模型。

快速上手

1. 1

   创建并激活虚拟环境

   python -m venv .venv && source .venv/bin/activate
2. 2

   使用 pip 安装 DeepSearcher

   pip install deepsearcher
3. 3

   设置 OPENAI_API_KEY 环境变量，然后运行 README 中的快速入门 Python 示例

使用前须知

• !需要 LLM 的 API 密钥（例如 OpenAI），或本地运行的模型（如 Ollama）。
• !需要向量数据库（如 Milvus 或 Zilliz Cloud），增加了部署工作量。
• !网页爬取文档功能仍在开发中，并且需要 FIRECRAWL_API_KEY。

标签

常见问题

deep-searcher 是什么？

开源深度研究工具，结合大模型与向量数据库，对私有数据进行检索、评估与推理。 DeepSearcher 是一个基于 Python 的项目，用于对私有数据进行问答和报告生成。它将 OpenAI、Qwen、DeepSeek、Claude、Llama 等大语言模型与 Milvus、Zilliz Cloud 等向量数据库结合，把问题拆解后在你自己的文档中检索，并综合出结果。

deep-searcher 可以免费使用吗？用的什么许可证？

deep-searcher 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

deep-searcher 还在维护吗？

活跃维护中。deep-searcher 最近一次提交是在 2026年9月22日。

deep-searcher 适合用来做什么？

为企业内部文档搭建问答助手，数据留在自有环境中。 基于一批 PDF 和笔记自动生成研究类报告。 通过 Ollama 使用本地模型，在离线环境中检索知识库。 快速验证检索增强生成（RAG）方案，并灵活替换大模型和 Embedding 模型。

deep-searcher 怎么安装和运行？

创建并激活虚拟环境: python -m venv .venv && source .venv/bin/activate 使用 pip 安装 DeepSearcher: pip install deepsearcher 设置 OPENAI_API_KEY 环境变量，然后运行 README 中的快速入门 Python 示例

在哪里获取 deep-searcher？

源代码和安装说明在 GitHub 上：https://github.com/zilliztech/deep-searcher