HoRain云--LangChain 环境搭建

发布时间:2026/7/10 21:52:51
HoRain云--LangChain 环境搭建 HoRain云小助手个人主页 个人专栏: 《Linux 系列教程》《c语言教程》⛺️生活的理想就是为了理想的生活!⛳️ 推荐前些天发现了一个超棒的服务器购买网站性价比超高大内存超划算忍不住分享一下给大家。点击跳转到网站。专栏介绍专栏名称专栏介绍《C语言》本专栏主要撰写C干货内容和编程技巧让大家从底层了解C把更多的知识由抽象到简单通俗易懂。《网络协议》本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘一起解密网络协议在运行中协议的基本运行机制《docker容器精解篇》全面深入解析 docker 容器从基础到进阶涵盖原理、操作、实践案例助您精通 docker。《linux系列》本专栏主要撰写Linux干货内容从基础到进阶知识由抽象到简单通俗易懂帮你从新手小白到扫地僧。《python 系列》本专栏着重撰写Python相关的干货内容与编程技巧助力大家从底层去认识Python将更多复杂的知识由抽象转化为简单易懂的内容。《试题库》本专栏主要是发布一些考试和练习题库涵盖软考、HCIE、HRCE、CCNA等目录⛳️ 推荐专栏介绍环境要求安装 LangChain安装核心包安装模型提供商包一键安装配置 API Key获取 API Key设置环境变量实例在代码中加载实例验证安装实例实例项目目录建议本篇将带你完成 LangChain 的安装和配置确保你能顺利运行第一个 LangChain 程序。环境要求项目最低版本推荐版本Python3.103.11 或 3.12pip22.0最新版操作系统macOS / Linux / Windows 均可检查 Python 版本$ python --version Python 3.12.7如果你还没有安装 Python可以参考我们的 Python3 环境搭建。Python 包与环境管理工具参考 uv 入门教程。安装 LangChainLangChain 采用模块化设计核心功能和第三方集成分开安装。安装核心包$ pip install langchain这个命令会安装 langchain 主包它包含了 init_chat_model()、create_agent() 等核心 API同时会自动安装 langchain-core 作为依赖。安装模型提供商包LangChain 本身不包含具体的模型实现你需要根据使用的模型安装对应的提供商包模型提供商安装命令使用的模型OpenAIpip install langchain-openaiGPT-4、GPT-5 等Anthropicpip install langchain-anthropicClaude 系列DeepSeekpip install langchain-deepseekDeepSeek-V3、R1 等Googlepip install langchain-google-genaiGemini 系列Ollama本地模型pip install langchain-ollamaLlama、Qwen 等本地模型xAIpip install langchain-xaiGrok 系列Mistralpip install langchain-mistralaiMistral 系列一键安装建议初学者直接安装以下组合$ pip install langchain langchain-openai python-dotenvpython-dotenv 用于从 .env 文件加载 API Key这是管理敏感信息的最佳实践可以避免将 Key 硬编码在代码中。配置 API Key获取 API Key以 OpenAI 为例你需要先注册账号并获取 API Key访问 https://platform.openai.com 注册或登录进入 API Keys 页面点击 Create new secret key复制生成的 Key格式为 sk-xxxxxxxxAPI Key 只会显示一次请立即保存到安全的地方。不要将 Key 提交到 Git 仓库或分享给他人。其他提供商的获取方式类似请参考对应文档。设置环境变量推荐使用 .env 文件管理 API Key。在项目根目录创建 .env 文件实例# 文件路径.env# 填入你的 API KeyOPENAI_API_KEYsk-your-api-key-here# 如果使用其他模型也在这里配置# ANTHROPIC_API_KEYsk-ant-your-key# DEEPSEEK_API_KEYsk-your-key然后创建 .gitignore 文件确保 .env 不会被提交# .gitignore .env __pycache__/ *.pyc在代码中加载实例# 文件路径config.py# 在程序开头加载 .env 文件import osfrom dotenv import load_dotenv# 加载 .env 文件中的环境变量load_dotenv()# 验证 API Key 是否加载成功api_key os.getenv(OPENAI_API_KEY)if api_key:# 只显示前8位和后4位避免泄露完整 Keyprint(fAPI Key 已加载: {api_key[:8]}...{api_key[-4:]})else:print(警告未找到 OPENAI_API_KEY请检查 .env 文件)验证安装运行以下脚本验证安装是否成功实例# 文件路径verify_install.py# 验证 LangChain 安装和 API Key 配置from dotenv import load_dotenvload_dotenv()# 测试 1验证 langchain 导入try:import langchainprint(flangchain 版本: {langchain.__version__})except ImportError:print(错误langchain 未安装请运行 pip install langchain)# 测试 2验证 langchain-openai 导入try:import langchain_openaiprint(langchain-openai 已安装)except ImportError:print(错误langchain-openai 未安装请运行 pip install langchain-openai)# 测试 3验证 API Key 配置import osapi_key os.getenv(OPENAI_API_KEY)if not api_key:print(错误OPENAI_API_KEY 未配置请在 .env 文件中设置)else:print(fAPI Key 配置成功: {api_key[:8]}...{api_key[-4:]})# 测试 4发送一条测试请求from langchain.chat_models import init_chat_modelmodel init_chat_model(openai:gpt-4o-mini)response model.invoke(用一句话介绍菜鸟教程RUNOOB)print(f\n模型回复: {response.content})运行结果langchain 版本: 1.3.0 langchain-openai 已安装 API Key 配置成功: sk-proj-z...xxxx 模型回复: 菜鸟教程RUNOOB是一个面向编程初学者的中文技术学习平台。如果最后一步报错请检查(1) API Key 是否正确(2) 是否有网络代理影响连接(3) 账户余额是否充足。国内我们可以采用 DeepSeek 大模型来测试如果还没有需要先去 DeepSeek 创建一个 API key。DeepSeek 的 API 文档参考首次调用 API | DeepSeek API Docs。如果你需要统一管理多个第三方模型可以选择安装 LiteLLM 作为模型网关pip install -U litellm不过本文的示例直接使用ChatOpenAI配合openai_api_base参数连接 DeepSeek无需额外安装 LiteLLM。实例import osfrom langchain_openai import ChatOpenAI# 建议将 API Key 放在环境变量中或者直接在此处赋值生产环境请勿硬编码# os.environ[DEEPSEEK_API_KEY] sk-你的DeepSeek密钥# 初始化模型llm ChatOpenAI(modeldeepseek-v4-pro, # DeepSeek V4 模型名称openai_api_keysk-你的Key, # 填入你的 DeepSeek API Keyopenai_api_basehttps://api.deepseek.com, # DeepSeek 的 API 地址temperature0.7,max_tokens1024)# 测试一下response llm.invoke(你好DeepSeek请做一个简短的自我介绍。)print(response.content)执行以上代码就会输出内容你好很高兴认识你 我是DeepSeek由深度求索公司创造的AI助手。我的特点包括 。。。项目目录建议推荐的项目目录结构langchain-learning/ ├── .env # API Key 配置不提交到 Git ├── .gitignore # Git 忽略规则 ├── config.py # 公共配置加载 ├── 01_hello_world.py # 第一篇的示例 ├── 02_first_agent.py # Agent 示例 └── ... # 更多练习❤️❤️❤️本人水平有限如有纰漏欢迎各位大佬评论批评指正如果觉得这篇文对你有帮助的话也请给个点赞、收藏下吧非常感谢! Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧