企业官网建设流程全解析

LangChain作为多模态智能体开发的核心框架，其依赖安装需结合开发需求（基础开发/复杂多模态开发）选择对应的版本，同时需适配Python版本与后续多模态依赖。本节将详细讲解LangChain基础版与完整版的安装流程、版本选型、依赖适配及安装验证，突出多模态场景下的依赖配置要点。

关于“多模态支持”的说明：LangChain本身并没有一个专门的“多模态版本”。多模态能力主要取决于以下三点的组合。

（1）底层模型支持：必须使用支持多模态的LLM，如 OpenAI 的 gpt-4o、Anthropic 的claude-3-5-sonnet、Google 的 gemini-1.5-pro 等。

（2）消息格式（Message Content Blocks）：LangChain 0.3.x 版本中，通过 HumanMessage 的 content 字段支持列表格式，允许混合传输文本和图片 URL/二进制数据。

（3）智能体框架（LangGraph）：官方强烈建议使用LangGraph来构建智能体（Agent），因为它对状态管理、多模态输入循环和工具调用的控制比旧版本的AgentExecutor更灵活、更稳定。

依赖包的版本锁定说明（参看requirements.txt）：

#核心组合（多模态智能体最优）

langchain==0.3.25

langgraph==1.0.5

langchain-core==0.3.75

langchain-community==0.4.1

#多模态依赖（必装）

pillow>=10.3.0 #图片处理（兼容最新多模态加载器）

pydub>=0.25.1 #音频处理

python-multipart>=0.0.9 #多模态数据解析

openai>=1.30.0 # GPT-4V/Claude 3多模态调用

google-generativeai>=0.7.1 # Gemini多模态适配

2.2.1 LangChain版本选型与适配说明

本书使用LangChain稳定版本0.3.x（如0.3.25），该版本大幅优化了多模态相关功能（如多模态提示词工程、多模态工具调用、MultiModalAgent优化），完美适配Python 3.11.x，是多模态智能体开发的首选版本；不推荐使用0.1.x版本（原因是多模态功能不完善，部分API已废弃，0.3版本解决了很多0.1/0.2版本的依赖冲突问题）。

根据开发需求，LangChain依赖分为两种安装方式，分别适配不同场景。

1）基础版安装

仅安装LangChain核心功能，适用于简单多模态智能体开发（如文本＋图像基础交互），依赖体积小，安装速度快。

2）完整版安装

安装LangChain核心功能＋所有可选依赖（含多模态工具、大模型API适配、文档处理等），适用于复杂多模态智能体开发（如工业巡检、医疗影像诊断等需要多工具协同的场景），无须手动安装额外依赖，可提升开发效率。

2.2.2 基础版安装流程（核心依赖）

基础版仅安装LangChain核心包，适合入门级开发或简单多模态任务，安装步骤如下：

（1）激活之前创建的多模态开发环境（conda或venv），确保环境已激活。

（2）执行安装命令：pip install langchain==0.3.25 langgraph==1.0.5（指定本书示例代码的运行版本，避免自动安装最新版本）。

（3）安装验证：安装完成后，在Python交互环境中执行命令：from langchain import LangChain。若未报错，则说明基础版安装成功。

（4）补充说明：基础版仅包含LangChain核心模块（提示词工程、链、代理等），若后续需要使用多模态工具、大模型API，则需手动安装对应依赖（如openai、opencv-python等）。

2.2.3 完整版安装流程（含多模态依赖）

完整版安装包含LangChain核心功能及所有可选依赖，尤其适配多模态智能体开发，无须手动安装额外工具依赖，安装步骤如下：

（1）激活多模态开发环境，确保pip版本≥23.0。

（2）执行安装命令：pip install langchain[all]==0.3.25；该命令将自动安装LangChain核心依赖包＋多模态工具（如OpenCV、Whisper）、大模型API客户端（如openai、baidu-aip）、文档处理工具（如unstructured）等所有依赖。

（3）安装注意事项：

①完整版依赖体积较大（约500MB＋），安装时间较长，建议切换国内PyPI源（如阿里云、清华源），提升安装速度，切换命令为：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

②若安装过程中出现“编译失败”（如OpenCV、FFmpeg相关报错），则需检查系统级依赖是否安装完成（参考2.1.1节）。Linux/macOS用户可重新安装系统依赖，Windows（WSL2）用户需确保WSL2环境配置正确。

③若出现版本冲突（如某依赖包版本不兼容），可执行命令pip install –upgrade 冲突依赖包名称，或使用pip install langchain[all]==0.3.25 --force-reinstall命令强制重新安装。

（4）安装验证：在Python交互环境中执行以下命令，验证多模态相关依赖是否安装成功（LangChain_Dependency_Verification_Tool.py），若未报错，则说明完整版安装成功，可正常使用多模态相关功能。

2.2.4 依赖版本管理与更新

多模态智能体开发过程中，LangChain及相关依赖会不断迭代，需做好版本管理，避免版本冲突，核心操作介绍如下。

1. 查看当前LangChain版本

执行命令pip show langchain，可查看版本号、安装路径及依赖包信息。

2. 版本更新

若需要升级LangChain版本，执行命令pip install --upgrade langchain（升级至最新稳定版，但是需要解决包函数变懂的问题），或pip install langchain==目标版本（指定版本升级）。

3. 依赖冲突解决

若更新后出现依赖冲突，可通过命令pip list查看所有依赖包版本，对比LangChain官方文档的推荐依赖版本，卸载冲突版本并安装推荐版本；也可通过命令conda env export导出当前环境配置，重新创建环境并安装对应版本依赖。