2.1 Install

本节介绍如何安装 LangChain 及其依赖。

---

系统要求

• Python 3.10+ - LangChain 要求 Python 3.10 或更高版本

---

基本安装

安装 LangChain 核心包：

pip install -U langchain

验证安装：

import langchain
print(langchain.__version__)

---

安装模型提供商集成

LangChain 采用模块化设计，模型集成包独立维护。根据需要安装：

OpenAI

pip install -U langchain-openai

from langchain_openai import ChatOpenAI

model = ChatOpenAI(model="gpt-4o")

Anthropic

pip install -U langchain-anthropic

from langchain_anthropic import ChatAnthropic

model = ChatAnthropic(model="claude-sonnet-4-5-20250929")

Google

pip install -U langchain-google-genai

from langchain_google_genai import ChatGoogleGenerativeAI

model = ChatGoogleGenerativeAI(model="gemini-pro")

AWS Bedrock

pip install -U langchain-aws

Azure OpenAI

pip install -U langchain-openai

本地模型 (Ollama)

pip install -U langchain-ollama

---

完整安装示例

一次性安装常用组件：

# 核心包 + 常用集成
pip install -U langchain langchain-openai langchain-anthropic

# 如果使用 LangGraph
pip install -U langgraph

# 如果使用 LangSmith
pip install -U langsmith

---

配置 API 密钥

方式一：环境变量

# OpenAI
export OPENAI_API_KEY="sk-..."

# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

# Google
export GOOGLE_API_KEY="..."

方式二：代码中设置

import os
os.environ["OPENAI_API_KEY"] = "sk-..."

# 或者在初始化时传入
from langchain_openai import ChatOpenAI
model = ChatOpenAI(api_key="sk-...")

方式三：使用 .env 文件

# .env 文件
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...

from dotenv import load_dotenv
load_dotenv()

---

验证安装

运行以下代码验证安装是否成功：

from langchain_openai import ChatOpenAI

# 初始化模型
model = ChatOpenAI(model="gpt-4o")

# 测试调用
response = model.invoke("Hello, LangChain!")
print(response.content)

---

常见问题

Python 版本不兼容

ERROR: langchain requires Python >=3.10

解决方案：升级 Python 到 3.10 或更高版本。

依赖冲突

# 使用虚拟环境隔离依赖
python -m venv langchain-env
source langchain-env/bin/activate  # Linux/Mac
# 或 langchain-env\Scripts\activate  # Windows

pip install -U langchain

API 密钥错误

AuthenticationError: Invalid API Key

解决方案：检查环境变量是否正确设置，密钥是否有效。

---

可选依赖

根据用途安装额外依赖：

用途	安装命令
向量存储	pip install faiss-cpu 或 pip install chromadb
文档加载	pip install unstructured
PDF 处理	pip install pypdf
网页抓取	pip install beautifulsoup4

---

上一节：2.0 Get Started

下一节：2.2 Quickstart