You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Mac运行localGPT克隆仓库报错:无法导入UnstructuredExcelLoader

问题分析与解决方案

这个错误不是路径问题,核心是langchain版本不兼容或模块导入路径变更导致的:

  • 早期版本的langchain中,UnstructuredExcelLoader不在langchain.document_loaders的根导入目录下;后续langchain拆分出langchain_community模块后,该类也随之迁移到了新模块中。

解决步骤:

  1. 检查并升级langchain相关依赖
    先查看当前安装的langchain版本:

    pip show langchain
    

    运行命令升级到兼容的最新版本:

    pip install --upgrade langchain langchain_community
    
  2. 修正导入语句(升级后仍报错时执行)
    打开项目中的constants.py文件,找到导入UnstructuredExcelLoader的代码行,替换为以下其中一种:

    # 适配langchain拆分community模块后的新版本
    from langchain_community.document_loaders import UnstructuredExcelLoader
    # 适配未拆分模块的旧版langchain
    from langchain.document_loaders.excel import UnstructuredExcelLoader
    
  3. 创建专属虚拟环境隔离依赖
    你当前使用Anaconda全局环境,容易出现跨项目的依赖版本冲突,建议为localGPT创建独立虚拟环境:

    # 创建指定Python版本的虚拟环境
    conda create -n localgpt_env python=3.10
    # 激活虚拟环境
    conda activate localgpt_env
    # 重新安装项目依赖
    pip install -r requirements.txt
    

    之后在该虚拟环境内运行ingest.py即可。

内容的提问来源于stack exchange,提问作者Scott B

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.19 00:27:18