PyInstaller打包Llama Index应用遇文件缺失错误，求解决方案及替代分发方式

在conda虚拟环境中使用PyInstaller打包Llama Index应用时出现以下错误：

FileNotFoundError: [Errno 2] No such file or directory: 'C:\Users\me\AppData\Local\Temp\_MEI140402\llama_index\VERSION'

本地运行程序正常，但打包为exe时频繁触发该错误，临时目录中确实不存在该VERSION文件。已将所有路径添加至pathex，并创建added_hook.py收集资源，但问题仍未解决。

附上当前spec文件代码：

# -*- mode: python ; coding: utf-8 -*-


a = Analysis(
    ['run.py'],
    pathex=[ all extra paths ],
    binaries=[],
    datas=[('added_hook.py', '.'),
    ],
    hiddenimports=['docmaker'],
    hookspath=['all hooks' ],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    noarchive=False,
)
pyz = PYZ(a.pure)

exe = EXE(
    pyz,
    a.scripts,
    a.binaries,
    a.datas,
    [],
    name='run',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    upx_exclude=[],
    runtime_tmpdir=None,
    console=True,
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
)

coll = COLLECT(
    exe,
    a.binaries,
    a.datas,
    strip=False,
    upx=True,
    upx_exclude=[],
    name='run',
)

added_hook.py代码：

from PyInstaller.utils.hooks import collect_data_files
# Instruct PyInstaller to collect data files from the 'resources' package.
datas = collect_data_files('resources')

1. 修复VERSION文件缺失问题 #

错误原因是PyInstaller未将Llama Index包内的VERSION数据文件打包进可执行文件，你的added_hook.py仅收集了resources包的资源，未处理llama_index的资源。

方法一：修改hook文件收集llama_index资源 #

更新added_hook.py，同时收集llama_index和resources的所有数据文件：

from PyInstaller.utils.hooks import collect_data_files
# 收集llama_index的所有数据文件（包括VERSION）
datas = collect_data_files('llama_index')
# 追加resources包的资源（如果需要）
datas += collect_data_files('resources')

方法二：手动在spec文件中指定VERSION路径 #

找到conda虚拟环境中llama_index包的VERSION文件路径（通常在你的虚拟环境路径/lib/site-packages/llama_index/VERSION），在spec文件的datas列表中添加该文件的映射：

datas=[
    ('added_hook.py', '.'),
    # 替换为你实际的VERSION文件路径
    ('C:/Users/me/miniconda3/envs/your_env/lib/site-packages/llama_index/VERSION', 'llama_index'),
],

额外检查项 #

• 确保pathex包含conda虚拟环境的site-packages路径，让PyInstaller能正确找到依赖包：

  pathex=[
      '你的额外路径',
      'C:/Users/me/miniconda3/envs/your_env/lib/site-packages'
  ],
  

• 若还有其他缺失的依赖模块，可添加到hiddenimports中，比如：

  hiddenimports=['docmaker', 'llama_index.core', 'llama_index.llms.openai'],
  

修改完成后，重新执行打包命令：

pyinstaller run.spec

如果PyInstaller的问题难以排查，可尝试以下替代方案：

• Conda打包：使用conda-build制作conda包，用户通过conda install即可安装，完美适配conda环境。
• Wheel包：用setuptools或poetry构建wheel包，用户通过pip install安装，适合通用Python环境。
• Nuitka：将Python代码编译为C级可执行文件，对依赖处理更严格，生成的文件性能更高。
• Docker容器：将应用、依赖和Python环境打包成Docker镜像，用户无需配置环境，直接运行容器即可。
• PyOxidizer：将Python解释器、应用代码和依赖打包为单一可执行文件，对数据文件的打包支持更完善。

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