MediaPipe模型制作器在macOS上的安装与兼容性问题解析

问题背景

MediaPipe模型制作器（MediaPipe Model Maker）是Google开发的一个强大工具，它能够帮助开发者快速训练和部署自定义的机器学习模型。然而，近期在macOS系统上安装和使用该工具时，用户遇到了一个常见的兼容性问题。

核心问题分析

当用户在macOS 15.3系统上使用Python 3.11环境安装MediaPipe模型制作器0.2.1.3版本后，尝试导入object_detector模块时，系统会抛出"ModuleNotFoundError: No module named 'keras.src.engine'"错误。这个问题的根源在于依赖库之间的版本冲突。

技术细节

深入分析错误堆栈可以发现，问题发生在tensorflow_addons库尝试从keras.src.engine导入keras_tensor时。这是由于较新版本的Keras（3.0及以上）改变了其内部模块结构，而MediaPipe模型制作器的某些依赖库尚未适配这一变化。

解决方案

经过技术验证，目前可行的解决方案是：

1. 使用Python 3.9环境（这是当前最稳定的支持版本）
2. 通过以下命令安装特定版本的依赖库：

   pip install "pyyaml>6.0.0" "keras<3.0.0" "tensorflow<2.16" "tf-models-official<2.16" mediapipe-model-maker --no-deps
   

这个解决方案的关键在于：

• 限制Keras版本在3.0以下
• 控制TensorFlow版本在2.16以下
• 使用--no-deps参数避免自动安装不兼容的依赖项

注意事项

值得注意的是，这个问题在虚拟环境中表现得尤为明显。测试表明，在系统全局Python环境中安装可能不会出现此问题，但在虚拟环境中则几乎必然会出现。这提示我们在使用MediaPipe模型制作器时，环境隔离需要格外谨慎。

未来展望

随着Keras和TensorFlow生态系统的持续演进，这类依赖冲突问题有望得到根本解决。建议开发者关注MediaPipe官方更新，以获取最新的兼容性信息。同时，对于生产环境的应用，建议固定所有相关库的版本号，确保环境的稳定性。

通过以上分析和解决方案，开发者应该能够顺利在macOS系统上使用MediaPipe模型制作器进行机器学习模型的开发和训练工作。