FaceSwap：extract/train/convert の Python 顔交換パイプライン

README Manifesto が線引きする用途

deepfakes/faceswap の README Manifesto は、技術公開当初の悪用を認めつつ、PhD なしで hands-on 学習できる最初の AI コードの一つだったと述べます。開発者は四原则を列挙：不適切コンテンツ作成用ではない、同意なし/隠蔽目的の顔交換用ではない、違法・疑わしい目的用ではない、実験・教育・映画・正当用途のため存在する、と README が明示。非倫理的使用には zero tolerance と README。ホーム faceswap.dev、ドキュメント faceswap.readthedocs.io、ライセンス GPL-3.0 です。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。

四段階 workflow：extract → train → convert → GUI

Overview は写真/動画収集→extract→train→convert を README が説明。extract は python faceswap.py extract で src から extract フォルダへ顔抽出。train は python faceswap.py train で 2 フォルダから models へ。convert は python faceswap.py convert で original→modified。GUI は python faceswap.py gui。詳細は USAGE.md 参照と README。動画ツール python tools.py effmpeg -h も README にあり、ffmpeg でフレーム分解→処理→再結合する代替も README が触れます。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。

INSTALL.md・CUDA・ROCm の README 要件

README は開始前に INSTALL.md を読むよう強調し、Windows/Linux/macOS 対応、best performance は modern GPU with CUDA、many AMD GPUs supported through ROCm (Linux) と記載。Python バージョンや conda 手順の詳細は README 本文にはなく INSTALL.md 側です。v3.0.0 release は 2025-12-21 の Windows/Linux/macOS Installers タグとして README 取得時 releases にあります。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。

フォーラム中心サポートと issue 方針

Help 節は Discord Server と FaceSwap Forum を案内。一般サポート質問は repo issues ではなく forum に投稿し削除され得ると README。Patreon/PayPal 支援者向け forum 投稿 URL も README 冒頭にあります。寄付先として Bitcoin/Ethereum/Monero/PayPal アドレスが README に列挙されています。セキュリティ監査記載は README にありません。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。

貢献者向け README 分岐

How to contribute は生成モデル興味者（faceswap-model ディスカッション）、devs（README 読了→fork→dev tag issues）、非 dev 上級ユーザー（advuser tag、forum で支援）、end-users（試して forum で質問）に分岐。README はコード実行問題を repo issue に開かないよう繰り返し警告します。機械学習背景は README が 2 本の動画リンク（顔認識/NN 入門）を提供し、詳細アルゴリズムは動画依存です。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。

README デモとモデル名の手がかり

README は Emma Stone/Scarlett Johansson の Phaze-A モデル、Jennifer Lawrence/Steve Buscemi の Villain モデルなどデモ動画リンクを載せ、モデル名の例示に使っています。ただし全モデル一覧や train ハイパーパラメータ表は README にはなく USAGE.md/docs 側です。effmpeg や GUI 経路のどちらを使うかは README が複数 entry point を認めています。

python faceswap.py extract で試す最小確認

README どおりの試用は INSTALL.md 後、setup フォルダで python faceswap.py extract を実行し src にテスト画像を置いて extract フォルダに顔 png が出るかを見る段階です。train は README が 2 フォルダ前提なので A/B 顔セットを小さく用意し models 配下に checkpoint ができるか、convert で modified に置換が走るかを順に確認します。GPU 認識は INSTALL.md の CUDA/ROCm 節と README の ROCm (Linux) 注記をセットで読む必要があり、README 単体では driver バージョン表はありません。

編集部の結論

FaceSwap は研究・映画 VFX 等の倫理的使用を README Manifesto で強調する教育向けパイプライン。同意のない顔交換用途は開発者が zero tolerance と明言。試すなら INSTALL.md 後に python faceswap.py extract で src→extract、train で models 生成、convert で modified を確認。CUDA GPU または Linux ROCm が README 推奨で、サポートは forum.faceswap.dev が README 指定窓口です。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes