OpenDeepSearch项目安装与配置指南

OpenDeepSearch项目安装与配置指南

【免费下载链接】OpenDeepSearch 项目地址: https://gitcode.com/gh_mirrors/op/OpenDeepSearch

1. 项目基础介绍

OpenDeepSearch 是一个轻量级但强大的搜索工具，旨在与 AI 代理无缝集成。它支持深度网络搜索和检索，特别优化了与 Hugging Face 的 SmolAgents 生态系统的兼容性。OpenDeepSearch 能够执行语义搜索，并提供两种操作模式：默认模式和深度搜索模式。该项目主要使用 Python 编程语言。

2. 关键技术与框架

OpenDeepSearch 使用以下关键技术：

• Crawl4AI：为 AI 提供数据抓取支持。
• Jina AI：提供即时使用的 API 密钥，用于语义搜索。
• Infinity Embeddings：支持自托管的重排解决方案。
• LiteLLM：用于高效 AI 模型集成的轻量级语言模型框架。
• SmolAgents：为代理框架和推理能力提供支持。

此外，项目还使用了多种开源库来增强搜索和检索功能。

3. 安装与配置

准备工作

在开始安装前，请确保您的系统中已安装以下软件：

• Python
• pip 或 uvicorn (推荐使用 uvicorn，因为它可以简化安装过程)

同时，您需要注册以下服务并获取相应的 API 密钥：

• Serper.dev
• Jina AI（如果选择使用 Jina 作为重排解决方案）
• 其他可能的服务，如 OpenAI、Anthropic 等（如果选择使用这些服务作为模型提供者）

安装步骤

1. 克隆项目到本地：

   git clone https://github.com/sentient-agi/OpenDeepSearch.git
   cd OpenDeepSearch
   

2. 安装项目依赖：

   pip install -e .
   pip install -r requirements.txt
   

   注意：确保已安装 torch。

3. 配置环境变量：

   将您的 API 密钥存储为环境变量。例如：

   export SERPER_API_KEY='your-serper-api-key-here'
   export OPENROUTER_API_KEY='your-openrouter-api-key-here'
   export JINA_API_KEY='your-jina-api-key-here'
   

   根据您选择的服务设置相应的环境变量。

4. 初始化 OpenDeepSearch：

   from opendeepsearch import OpenDeepSearchTool
   
   search_agent = OpenDeepSearchTool(
       model_name="openrouter/google/gemini-2.0-flash-001",
       reranker="jina"  # 或者 "infinity"，如果您选择自托管的重排解决方案
   )
   

5. 运行 Gradio Demo 以交互方式测试搜索查询：

   python gradio_demo.py
   

   运行此命令后，将启动一个本地 Web 界面，您可以在其中测试不同的搜索查询和模式。

按照以上步骤，您应该能够成功安装和配置 OpenDeepSearch 项目。如果遇到任何问题，请查阅项目文档或向社区寻求帮助。

【免费下载链接】OpenDeepSearch 项目地址: https://gitcode.com/gh_mirrors/op/OpenDeepSearch