LangChain 安装指南

LangChain 安装指南

本指南说明如何安装 LangChain 及其相关生态系统包。LangChain 的设计是模块化的，允许您根据需要选择安装特定的功能部分。

1. 环境准备

在开始安装之前，请确保您的系统已具备：

• Python (推荐版本 3.8 或更高)
• pip (Python 包管理器)

建议： 在虚拟环境 (如 venv 或 conda) 中进行安装，以隔离项目依赖。

2. 安装核心 langchain 包

这是使用 LangChain 的基础包，包含了核心抽象、LangChain 表达式语言 (LCEL) 以及 langchain-core 依赖。

使用 pip 安装：

pip install langchain

• 此命令会安装 langchain 包及其必要的依赖项，如 langchain-core。
• 注意： 仅安装此包不足以连接到具体的大语言模型 (LLM) 或数据存储。需要额外安装相应的集成包。

3. 安装集成 (Integrations)

LangChain 的主要价值在于其与各种 LLM 供应商、数据存储等的集成。这些集成通常需要安装额外的依赖。

• 特定提供商包: 某些大型集成（如 OpenAI, Anthropic）有自己的专属包。

  • 例如，要使用 OpenAI 模型，请运行：

    pip install langchain-openai
    

  • 请查阅 LangChain 的 集成文档 或 API 参考 中的 "Third Party Libraries" 部分，以确认特定集成是否需要单独的包。

• 社区包: 许多其他集成包含在 langchain-community 包中。

  • 安装此包：

    pip install langchain-community
    

  • 您可能需要根据具体需求同时安装 langchain-community 和特定的提供商包（如 langchain-openai）。

4. 其他可选的 LangChain 生态系统包

根据您的需求，可能还会用到以下包：

• langchain-core: 包含基础抽象和 LCEL。通常由 langchain 自动安装，但也可单独安装 (pip install langchain-core)。
• langchain-experimental: 包含实验性代码，用于研究和探索。

  pip install langchain-experimental
  

• langgraph: 用于构建有状态、多参与者 LLM 应用的库。

  pip install langgraph
  

• langserve: 用于将 LangChain 链部署为 REST API。通常由 LangChain CLI 安装。
  • 完整安装 (客户端+服务器):

    pip install "langserve[all]"
    

  • 仅客户端: pip install "langserve[client]"
  • 仅服务器: pip install "langserve[server]"
• langchain-cli: 命令行工具，用于处理 LangChain 模板和 LangServe 项目。

  pip install langchain-cli
  

• langsmith: 用于调试、追踪、监控和评估 LLM 应用的 SDK。通常由 langchain 自动安装部分依赖，也可独立安装 (pip install langsmith)。

5. 验证安装

安装完成后，可以在 Python 环境中尝试导入已安装的包来验证：

try:
    import langchain
    import langchain_core
    # import langchain_openai # 如果安装了 OpenAI 集成
    # import langchain_community # 如果安装了社区包
    print("LangChain core and related packages imported successfully.")
except ImportError as e:
    print(f"Error importing LangChain packages: {e}")

6. 从源代码安装 (高级)

如果需要从源代码安装特定包：

1. 克隆 LangChain 主仓库: git clone https://github.com/langchain-ai/langchain.git
2. 进入目标包的目录: cd langchain/libs/{package_name} (例如 cd langchain/libs/core)
3. 运行本地安装命令:

   pip install -e .
   

请根据您的项目需求选择并安装相应的包。首先安装 langchain，然后根据需要添加集成包（如 langchain-openai 和/或 langchain-community）是常见的起始步骤。