MediaPipe と NumPy：依存関係の制約とバイナリー読み込みエラーを区別する
インストール時に依存関係の解決で失敗する場合と、インストール完了後に拡張機能の読み込みで失敗する場合があります。すべてのリリースに過去の制約を適用せず、実際の MediaPipe 配布パッケージを確認します。
対象範囲と症状
インストール時に依存関係の解決で失敗する場合と、インストール完了後に拡張機能の読み込みで失敗する場合があります。すべてのリリースに過去の制約を適用せず、実際の MediaPipe 配布パッケージを確認します。
検索の手掛かりとなる断片です。表現や状況は環境によって異なります。
mediapipe
_ARRAY_API not found
出典から確認できること
MediaPipe の Python セットアップガイド（英語）は、サポート対象のデスクトッププラットフォームと python -m pip install mediapipe を記載していますが、すべてのリリースに適用できる NumPy のバージョンを一つ指定しているわけではありません。2024 年の 問題報告（英語）では、MediaPipe 0.10.15 に対して numpy<2 が報告されました。現在の PyPI 1.0.1 のメタデータと wheel 一覧（英語）では、上限を付けずに numpy が宣言され、プラットフォーム別の wheel が提供されています。そのため、過去の問題報告を現在の全環境に適用できる固定条件として使うことはできません。NumPy の読み込みエラーガイド（英語）では、_ARRAY_API not found と numpy.dtype size changed が下流のバイナリー互換性の問題として発生する可能性を説明しています。traceback で NumPy 以外の最初のフレームを確認すると、失敗しているパッケージを特定する手掛かりになります。
区別すべき状況
1. 実際にインストールされている MediaPipe のリリースと別のパッケージが、互換性のない NumPy の範囲を宣言している。または、インタープリターやプラットフォームに合う wheel が pip で見つからない。
2. インストールは完了したが、下流のネイティブ拡張機能の読み込み時に _ARRAY_API、dtype size changed、または別の ABI エラーが発生する。同じノードスタック内の別のパッケージが失敗している可能性もある。
3. 読み込みは成功し、残る問題がノードのリソース、画像表現、またはモデル操作に関係している。
推奨する確認手順
この手順は編集上の案内であり、お使いのマシンの診断結果ではありません。
手順 1. ComfyUI の起動に使う Python 実行ファイルで、MediaPipe、NumPy、ノードのバージョン、インタープリターとアーキテクチャ、pip が選択した wheel、依存関係解決エラーまたは完全な traceback を記録します。インストールと実行時の読み込みを区別します。
手順 2. 該当するリリースの Requires-Dist を確認し、依存関係のチェックを実行します。影響を受けるすべてのパッケージの範囲を比較します。0.10.15 の議論に numpy<2 があるという理由だけで、共有環境にその指定を貼り付けないでください。
手順 3. サポート対象の範囲に共通部分がなければ、ワークロードを分離します。ABI エラーの場合は、NumPy の traceback に関する案内に従って NumPy 以外の最初のフレームから原因のパッケージを特定し、復旧可能なコピー環境で、そのパッケージの保守されている互換リリースまたは文書化された再ビルドを試します。出所不明のバイナリーや、広範囲な再インストールの繰り返しは避けてください。
手順 4. 失敗していた読み込みが通ったら、ノード作者が提示する個人情報を含まない最小入力を実行し、NumPy を利用する他の既存パッケージも回帰確認します。その後に起きるモデルパスや画像形式のエラーは別の段階の問題であり、バージョンを再びダウングレードする根拠にはなりません。
完了の確認
依存関係のメタデータに矛盾がなく、関連するネイティブの読み込みが成功し、最小構成のノードと既存のワークフローの両方が動作します。
制限と注意点
現在のメタデータで numpy に広い範囲が宣言されていても、共有の ComfyUI 環境にあるすべてのネイティブ拡張機能が、あらゆる NumPy ビルドで動作するとは限りません。プラットフォームごとに wheel の提供状況も異なります。メタデータのチェックに通っても、ABI や機能の互換性が確認できたことにはなりません。
資料確認日：2026-09-26。パッケージのインストール、ネイティブの読み込み、MediaPipe のタスク、GPU 推論、お使いの環境の修復は実行していません。
参照した原文資料
- MediaPipe の Python セットアップ（英語）（確認日：2026-09-26）
- MediaPipe issue 5676：過去の NumPy 制約（英語）（確認日：2026-09-26）
- MediaPipe の PyPI リリースファイル（英語）（確認日：2026-09-26）
- NumPy の読み込みエラーのトラブルシューティング（英語）（確認日：2026-09-26）
関連ガイド
次に考えられる原因を確認
同じ症状にも異なる原因があります。関連する記事を順に確認してください。
ログ全体をエラー検索に貼り付けるこの記事は役に立ちましたか？
匿名です。はい・いいえの件数のみ保存し、アカウント、IP アドレス、端末情報は保存しません。
出典と参考資料
2026-09-26 に英語資料として MediaPipe のセットアップ資料、過去の 0.10.15 の問題報告、現在の PyPI 1.0.1 のメタデータと wheel、NumPy の ABI トラブルシューティングを確認しました。インストール、ネイティブの読み込み、タスクの実行は行っていません。
01MediaPipe の Python セットアップ（英語）出典の確認日: 2026-09-2602MediaPipe の問題報告 5676：過去の NumPy 制約（英語）出典の確認日: 2026-09-2603MediaPipe の PyPI リリースファイル（英語）出典の確認日: 2026-09-2604NumPy の読み込みエラーのトラブルシューティング（英語）出典の確認日: 2026-09-26問題を報告 · 337ea509-787c-537d-97a5-76d8cf34ff20
関連記事
編集者がこのページに関連づけた記事です。
環境と一つの管理された変更を記録し、メタデータと実行時の成功を区別します。