No module named av：FFmpeg をインストールしても Python のインポートが直らない理由
PyAV、そのリンク先ライブラリ、外部の FFmpeg 実行ファイルを別々の依存関係として確認してください。
対象範囲と症状
No module named 'av'、ネイティブライブラリのインポートエラー、外部の ffmpeg コマンドの失敗、メディアのデコードエラーは、それぞれ異なる段階で発生します。パッケージを変更する前に、どの処理で失敗しているか特定してください。
出典から確認できること
現行のPyAV インストールガイド（英語）では、リリース 18.1.0 に Python 3.11 以降が必要と説明されています。Linux、macOS、Windows 用のバイナリー wheel には FFmpeg ライブラリが同梱されています。一方、独自の FFmpeg を使って PyAV をソースからビルドするには、対応する開発ライブラリとツールが必要です。PyAV は av としてインポートされ、Python からメディアコンテナーやフレームを扱えます。FFmpeg コマンドラインツール（英語）は別の実行ファイルです。その実行ファイルだけをインストールしても Python バインディングはインストールされず、PyAV wheel をインポートできても、ノードが外部コマンドを起動できるとは限りません。
区別すべき状況
1. ComfyUI を起動する Python 実行ファイルから av が見つからない。または、選択した PyAV リリースに対応するインタープリターやプラットフォームの wheel がない。
2. av はインストールされているものの、ネイティブ拡張や FFmpeg ライブラリの読み込みに失敗する。ソースビルドのエラーでは、バイナリー wheel のインポートエラーとは異なる前提条件が関係する。
3. ノードが外部の ffmpeg／ffprobe プロセスを起動するが、その実行ファイルが見つからないか、別の実行ファイルを指している。
4. Python のインポートと実行ファイルの検索は成功するが、特定のコンテナー、コーデック、トラック、ファイルのデコードまたはエンコードで失敗する。
推奨する確認手順
この手順は編集上の案内であり、お使いのマシンの診断結果ではありません。
手順 1. 最初から最後までの traceback またはサブプロセスのエラーを保存します。ComfyUI を起動する実際のインタープリターで、Python、PyAV、ノードのバージョンとパッケージの配布元を記録します：python -m pip show av。信頼できるインストールであれば、そのインタープリターを使って python -c "import av; print(av.__version__); print(av.library_versions)" を実行して確認します。
手順 2. インポートできない場合は、ノードが指定する PyAV の対応範囲を、そのインタープリターおよびリリースの wheel 要件と照合します。現行の PyAV 18.1.0 が古い Python に対応していると決めつけないでください。ネイティブインポートまたはソースビルドに失敗する場合は、最初に表示された不足ライブラリ、ヘッダー、コンパイラのメッセージを保存し、システムの FFmpeg を変更する前に、使用中の wheel またはソースアーティファクトを調べます。
手順 3. 外部プロセスのエラーの場合に限り、ノードが選択した実行ファイルのパスを特定し、同じ実行ファイルをテストします。FFmpeg CLI のバージョンと、av.library_versions が報告するライブラリのバージョンは別の情報です。
手順 4. 復旧可能なコピーで、公開可能な短い動画と失敗するノード操作を使い、ファイルを開く処理、1 フレームの読み込み、必要な音声または出力コーデックをテストします。元の入力は変更せず、依存パッケージは一度に一つだけ変更します。
完了の確認
実際のプロセスで必要な Python インポートまたは外部実行ファイルが動作し、対象となる短いメディア処理が成功することを確認します。インポートに成功しただけでは、コーデックへの対応やノードの最終ワークフローが確認されたことにはなりません。
制限と注意点
PyAV の wheel、ソースビルド、FFmpeg CLI の要件はリリースとプラットフォームによって異なります。一つの Python モジュールが見つからない問題を修正するために、FFmpeg 全体やすべての動画ノードを置き換えないでください。
出典確認日：2026-09-26。ローカルでのパッケージインストール、ネイティブビルド、動画デコード、GPU 実行は行っていません。
参照した原文資料
- PyAV インストールのドキュメント（英語）（確認日：2026-09-26）
- PyAV の概要と基本デモ（英語）（確認日：2026-09-26）
- FFmpeg コマンドラインのドキュメント（英語）（確認日：2026-09-26）
関連ガイド
次に考えられる原因を確認
同じ症状にも異なる原因があります。関連する記事を順に確認してください。
ログ全体をエラー検索に貼り付けるこの記事は役に立ちましたか？
匿名です。はい・いいえの件数のみ保存し、アカウント、IP アドレス、端末情報は保存しません。
出典と参考資料
2026-09-26 に PyAV と FFmpeg の一次資料を確認し、英語資料に基づく編集レビューを行いました。パッケージ、ネイティブビルド、メディア、GPU の実行は行っていません。
01PyAV インストールのドキュメント（英語）出典の確認日: 2026-09-2602PyAV の概要と基本デモ（英語）出典の確認日: 2026-09-2603FFmpeg コマンドラインのドキュメント（英語）出典の確認日: 2026-09-26問題を報告 · 3ea6f31b-4008-5206-aaa3-96957ecf66f7
関連記事
編集者がこのページに関連づけた記事です。
環境と一つの管理された変更を記録し、メタデータと実行時の成功を区別します。