langchain

环境要求

• Python 环境（LangChain 是 Python 框架/库）
• uv 包管理工具（README 的 Quickstart 使用 uv add 安装）
• OpenAI 等模型提供商的 API Key（示例调用 openai:gpt-5.5）

安装与启动步骤

1. 1准备项目环境

   LangChain 是 Python 库，先确认本机已有 Python 环境，并在你的项目目录中操作，后续依赖会装到该环境里。

2. 2添加 langchain 依赖

   在项目目录执行 README Quickstart 给出的命令，把 langchain 加入依赖并完成安装。

   uv add langchain

   复制

3. 3配置模型密钥

   示例调用的是 OpenAI 模型，需要先准备好该提供商的 API Key 并配置为环境变量，不要把密钥写死在代码里。

   export OPENAI_API_KEY=sk-xxxxxxxx

   复制

4. 4编写最小示例

   新建 quickstart.py，写入 README 中的最小调用代码：初始化模型并向其发送一句 Hello, world!。

   from langchain.chat_models import init_chat_model
   
   model = init_chat_model("openai:gpt-5.5")
   result = model.invoke("Hello, world!")

   复制

5. 5运行示例脚本

   在同一个环境里执行脚本，验证依赖安装与模型调用链路是否打通。

   python quickstart.py

   复制

关键配置

如何确认成功

运行 quickstart.py 后终端正常打印出模型返回的文本内容（对 Hello, world! 的回复），且不出现鉴权或导入报错，即为成功。

常见问题

注意事项

• README 使用 uv 管理依赖，你也可以按团队习惯换成其他 Python 包管理方式。
• README 未声明具体的 Python 版本要求，实际支持版本请以官方文档为准。
• 密钥的环境变量名取决于所选模型提供商，上面仅为示例，务必以提供商文档为准并避免硬编码。
• 更多用法与进阶内容见官网文档 https://docs.langchain.com/langchain。