在MacOS上安装kokoro-onnx项目时解决onnxruntime版本依赖问题

背景介绍

kokoro-onnx是一个基于ONNX运行时(ONNX Runtime)的开源项目，它需要特定版本的ONNX Runtime作为依赖。在MacOS系统上安装时，用户可能会遇到版本兼容性问题，特别是当系统已安装的ONNX Runtime版本不符合项目要求时。

常见问题分析

在MacOS上使用Homebrew安装onnxruntime时，默认安装的版本(1.20.0)可能低于kokoro-onnx项目要求的最低版本(1.20.1)。这种微小的版本差异会导致pip安装失败，出现"Could not find a version that satisfies the requirement onnxruntime>=1.20.1"的错误提示。

解决方案

方法一：使用pip直接安装正确版本的onnxruntime

1. 首先卸载通过Homebrew安装的onnxruntime：

   brew uninstall onnxruntime
   

2. 使用pip安装符合要求的onnxruntime版本：

   pip3 install onnxruntime>=1.20.1
   

3. 然后再安装kokoro-onnx：

   pip3 install kokoro-onnx
   

方法二：从源码编译安装onnxruntime

如果pip仓库中没有提供适合MacOS的预编译版本，可以考虑从源码编译：

1. 克隆onnxruntime仓库：

   git clone --recursive https://github.com/microsoft/onnxruntime
   

2. 切换到稳定版本分支(如1.20.1)：

   git checkout v1.20.1
   

3. 创建构建目录并配置：

   mkdir build && cd build
   cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo
   

4. 编译并安装：

   make -j$(sysctl -n hw.logicalcpu)
   sudo make install
   

注意事项

1. 从源码编译需要安装CMake和适当的C++编译工具链
2. 确保Python环境与编译的onnxruntime版本兼容
3. 编译过程可能需要较长时间，取决于机器性能
4. 如果遇到权限问题，可以考虑使用虚拟环境安装

结论

在MacOS上安装kokoro-onnx项目时，正确处理onnxruntime的版本依赖是关键。推荐优先使用pip安装预编译版本，只有在必要时才考虑从源码编译。通过正确管理依赖关系，可以确保项目顺利运行并获得最佳性能。