Langchain Dependencies

核心原则：

• LangChain 1.0 是当前的长期支持（LTS）版本。 新项目请始终基于 1.0+ 构建。LangChain 0.3 处于旧版维护阶段，仅接收安全修复——请勿将其用于新项目。
• langchain-core 是共享的基础库：请始终与其他任何包一起显式安装它。
• langchain-community（仅限 Python）不遵循语义化版本控制；请保守地锁定其版本。
• LangGraph 与 Deep Agents 的选型： 根据你的使用场景选择一种编排方案——它们是互为替代的方案，而非必须同时使用的技术栈（参见下方的 框架选择）。
• 提供商集成（模型、向量数据库、工具）均单独安装，因此你只需引入实际使用的包。

环境要求

框架选择

两者均构建于 langchain + langchain-core + langsmith 之上。

核心包

Python — 始终必需

Python — 编排层（二选一）

Python — 模型提供商（选择你实际使用的包）

Python — 常用工具与检索包

这些包具有更严格的兼容性要求——除非有特殊原因，建议始终使用最新的可用版本。

langchain-community 稳定性说明： 该包不遵循语义化版本控制。次版本（Minor）发布中可能包含破坏性变更。存在专属集成包时（例如 langchain-chroma、langchain-tavily），请优先使用专属包——它们具备独立版本控制且更加稳定。

TypeScript — 始终必需

TypeScript — 编排层（二选一）

TypeScript — 模型提供商（选择你实际使用的包）

TypeScript — 常用工具与检索包

在 Yarn Workspaces 和 Monorepo 仓库中，必须显式安装 @langchain/core——作为对等依赖项，它并不总是会被自动提升（Hoist）。

最小项目模板

# requirements.txt
langchain>=1.0,<2.0
langchain-core>=1.0,<2.0
langgraph>=1.0,<2.0
langsmith>=0.3.0

# 添加你使用的模型提供商，例如：
# langchain-openai
# langchain-anthropic
# langchain-google-genai

{
  "dependencies": {
    "@langchain/core": "^1.0.0",
    "langchain": "^1.0.0",
    "@langchain/langgraph": "^1.0.0",
    "langsmith": "^0.3.0"
  }
}

# requirements.txt
deepagents            # 内部已打包 langgraph
langchain>=1.0,<2.0
langchain-core>=1.0,<2.0
langsmith>=0.3.0

# 添加你使用的模型提供商，例如：
# langchain-anthropic
# langchain-openai

{
  "dependencies": {
    "deepagents": "latest",
    "@langchain/core": "^1.0.0",
    "langchain": "^1.0.0",
    "langsmith": "^0.3.0"
  }
}

# requirements.txt
langchain>=1.0,<2.0
langchain-core>=1.0,<2.0
langgraph>=1.0,<2.0
langsmith>=0.3.0

# 网络搜索
langchain-tavily          # 使用最新版本；官方合作包，遵循语义化版本

# 向量数据库 — 选择一个：
langchain-chroma          # 使用最新版本；官方合作包，遵循语义化版本
# langchain-pinecone      # 使用最新版本；官方合作包，遵循语义化版本
# langchain-qdrant        # 使用最新版本；官方合作包，遵循语义化版本

# 文本处理
langchain-text-splitters  # 使用最新版本；遵循语义化版本

# 你的模型提供商：
# langchain-openai / langchain-anthropic / 等

{
  "dependencies": {
    "@langchain/core": "^1.0.0",
    "langchain": "^1.0.0",
    "@langchain/langgraph": "^1.0.0",
    "langsmith": "^0.3.0",
    "@langchain/tavily": "latest",
    "@langchain/pinecone": "latest"
  }
}

版本控制策略与升级指南

对于所有遵循语义化版本控制的包，破坏性变更仅发生在主版本号升级中（1.x → 2.x）。已废弃的功能在整个 1.x 系列中仍可正常运行，并会伴随警告信息。

优先使用专属集成包，而非 langchain-community。 当专属包存在时（例如使用 langchain-chroma 替代 langchain-community 中的 Chroma 集成），请务必使用专属包——专属包具备独立版本控制且测试更完善。

除非项目要求严格锁定的环境，社区工具包（Tavily、向量数据库等）应保持最新版本。 这些包会随 LangChain/LangGraph 的更新频繁发布兼容性修复。

环境变量

# LangSmith（强烈建议配置以实现可观测性）
LANGSMITH_API_KEY=<your-key>
LANGSMITH_PROJECT=<project-name>   # 可选，默认为 "default"

# 模型提供商 — 设置你实际使用的提供商密钥
OPENAI_API_KEY=<your-key>
ANTHROPIC_API_KEY=<your-key>
GOOGLE_API_KEY=<your-key>
MISTRAL_API_KEY=<your-key>
GROQ_API_KEY=<your-key>
COHERE_API_KEY=<your-key>
FIREWORKS_API_KEY=<your-key>
TOGETHER_API_KEY=<your-key>
HUGGINGFACEHUB_API_TOKEN=<your-key>

# 常用工具/检索服务
TAVILY_API_KEY=<your-key>          # 用于 Tavily 搜索
PINECONE_API_KEY=<your-key>        # 用于 Pinecone

常见错误

# 错误做法：旧版本，无新特性，仅维护安全补丁
langchain>=0.3,<0.4

# 正确做法：LangChain 1.0 LTS
langchain>=1.0,<2.0

# 错误做法：允许可能包含破坏性变更的次版本升级
langchain-community>=0.4

# 正确做法：锁定具体的次版本系列
langchain-community>=0.4.0,<0.5.0

同时建议：若存在对应的专属集成包，请切换使用（例如使用 langchain-chroma 替代 community 中的 Chroma 集成）。

# 风险做法：旧的锁定版本可能与 LangChain 1.0 不兼容
langchain-tavily==0.0.1

# 推荐做法：允许当前主版本内的最新版本
langchain-tavily>=0.1

# 错误做法 — 已弃用的 community 导入路径
from langchain_community.tools.tavily_search import TavilySearchResults
from langchain_community.tools import WikipediaQueryRun
from langchain_community.vectorstores import Chroma
from langchain_community.vectorstores import Pinecone

# 正确做法 — 使用专属包导入
from langchain_tavily import TavilySearch                  # pip: langchain-tavily（TavilySearchResults 已废弃）
from langchain_community.tools import WikipediaQueryRun  # 暂无专属包
from langchain_chroma import Chroma                       # pip: langchain-chroma
from langchain_pinecone import PineconeVectorStore        # pip: langchain-pinecone

要查找任何集成的当前规范导入方式，请查阅集成目录： https://python.langchain.com/docs/integrations/tools/

每个条目都会标明正确的安装包和导入路径。如果存在专属包，请优先使用——虽然 community 路径可能仍然有效，但已被视为旧版遗产。

// 错误做法：缺失 @langchain/core（在 yarn workspaces / 严格提升模式下会报错）
{
  "dependencies": {
    "@langchain/langgraph": "^1.0.0"
  }
}

// 正确做法：始终显式声明 @langchain/core
{
  "dependencies": {
    "@langchain/core": "^1.0.0",
    "@langchain/langgraph": "^1.0.0"
  }
}

# 安装前进行校验
import sys
assert sys.version_info >= (3, 10), "LangChain 1.0 要求 Python 3.10+ 环境"

# 安装前进行校验
node --version   # 必须是 v20.x 或更高版本