使用PyInstaller打包GPT4All Python脚本时遇TypeError求助

问题场景 #

将调用GPT4All的Python脚本通过PyInstaller打包为exe时，运行报错：执行check_requirement("importlib_resources < 1.2.0")时传入的version为NoneType，触发TypeError。涉及脚本代码：

from gpt4all import GPT4All

model = GPT4All("Meta-Llama-3-8B-Instruct.Q4_0.gguf", device='cpu')  # downloads / loads a 4.66GB LLM
with model.chat_session():
    with open("C:\Temp\Antwort.txt", "a") as a:
        print(model.generate("What is the capital of France?", max_tokens=1024), file=a)

原因分析 #

PyInstaller打包过程中未能正确捕获importlib_resources的版本信息，导致GPT4All的依赖检查函数check_requirement无法获取有效版本号，传入None值引发类型错误。

解决步骤 #

• 步骤1：固定importlib_resources版本
  在Python环境中安装符合要求的指定版本：

pip install importlib_resources==1.1.0

• 步骤2：打包时添加隐藏导入
  PyInstaller可能未自动包含相关模块，打包命令需手动指定隐藏导入：

pyinstaller --onefile --hidden-import=importlib_resources your_script_name.py

（替换your_script_name.py为你的实际脚本文件名）

• 步骤3：修正文件路径转义问题
  Windows路径需避免转义错误，可改用原始字符串或双反斜杠：

# 原始字符串写法
with open(r"C:\Temp\Antwort.txt", "a") as a:
# 双反斜杠写法
with open("C:\\Temp\\Antwort.txt", "a") as a:

• 步骤4：临时跳过依赖检查（备选）
  若上述方法无效，可修改GPT4All库中的check_requirement函数，临时跳过版本检查：
  找到GPT4All包内的依赖检查文件（通常在gpt4all目录下的utils或类似文件中），将函数修改为：

def check_requirement(req):
    return  # 直接跳过检查

内容的提问来源于stack exchange，提问作者lbu