安装 mediapipe_model_maker 时出现依赖冲突错误，根本原因在于其强依赖的 mediapipe 包暂不支持 Python 3.12 及 32 位系统；推荐使用 Python 3.11（64 位）环境以确保兼容性。
安装 `mediapipe_model_maker` 时出现依赖冲突错误，根本原因在于其强依赖的 `mediapipe` 包暂不支持 python 3.12 及 32 位系统；推荐使用 python 3.11（64 位）环境以确保兼容性。
mediapipe_model_maker 是 Google 提供的轻量级模型定制工具，用于快速微调 MediaPipe 预训练模型（如图像分类、目标检测等）。但其安装过程常因底层依赖 mediapipe 的严格版本约束而失败，典型报错如下：
ERROR: Cannot install mediapipe-model-maker==0.1.1.1, mediapipe-model-maker==0.1.1.0, ...
The conflict is caused by:
mediapipe-model-maker 0.1.1.1 depends on mediapipe==0.9.2.1
mediapipe-model-maker 0.1.0.2 depends on mediapipe==0.9.0.1该错误并非由用户显式指定多版本引起，而是 pip 在解析传递依赖时发现不同 mediapipe_model_maker 版本对 mediapipe 的要求互斥（如 0.9.0.1 vs 0.9.2.1），进而触发依赖解析器的“ResolutionImpossible”终止机制。
关键限制：mediapipe 当前（v0.10.9 及更早）仅提供 64 位架构的 wheel 包，且官方 PyPI 页面明确标注 —— 不支持 Python 3.12，也无任何 32 位（win32 / i686）构建产物。 这意味着：
- ✅ 推荐环境：Python 3.11（64-bit） + pip ≥ 22.0
- ❌ 不兼容环境：Python 3.12+、任何 32 位 Python（即使为 3.11）、conda 默认通道未适配的环境
✅ 正确安装步骤（以 Python 3.11.9 64-bit 为例）
-
确认 Python 版本与架构：
python --version # 应输出类似 "Python 3.11.9" python -c "import platform; print(platform.architecture())" # 应输出 ('64bit', 'WindowsPE') 或类似 -
升级 pip 并清理缓存（避免旧轮子干扰）：
python -m pip install --upgrade pip pip cache purge
-
直接安装（无需指定版本）：
pip install mediapipe-model-maker
✨ pip 将自动选择与当前 Python 兼配的最高可用 mediapipe_model_maker 版本（如 0.1.1.1）及其对应 mediapipe==0.9.2.1，全程无冲突。
⚠️ 注意事项与常见误区
- 不要手动指定 mediapipe 版本：例如 pip install mediapipe==0.9.2.1 后再装 mediapipe-model-maker，反而可能因版本锁定引发新冲突；
- 避免使用 --force-reinstall 或 --no-deps：这会破坏依赖图完整性，导致运行时报 ImportError；
- Conda 用户建议切换至 pip 环境：conda install -c conda-forge mediapipe-model-maker 目前同步滞后且依赖链不可控，官方明确推荐 pip 安装；
-
验证安装成功：
from mediapipe_model_maker import image_classifier print("✅ MediaPipe Model Maker imported successfully!")
总结
mediapipe_model_maker 的安装失败本质是生态兼容性问题，而非配置错误。核心解法始终是匹配其底层依赖 mediapipe 的运行时约束：使用 Python ≤ 3.11 的 64 位环境。 一旦环境就绪，pip install mediapipe-model-maker 即可开箱即用。未来当 mediapipe 官方发布 Python 3.12 支持后，此限制将自然解除——建议关注 MediaPipe GitHub Releases 获取更新动态。
