FaceNinja

Creator Kit · VTuber向け · 無料

あなたの顔で、あなたの配信を。

FaceNinjaのヘッドを、Unreal Engine 5.8の小さなステージで、あなたと一緒に話して動くMetaHumanにします。作るのは、7つのプロンプトを受け取ったコーディングエージェントです。入力すれば話し、笑えば笑います。それをOBSでキャプチャします。

バージョン 0.3.1 · 6.6 MB · MITライセンス · WindowsとMac

スクリプトとエージェント向けのサイズとSHA-256:version.json

キットの概要
バージョン0.3.1
サイズ6.6 MB · zip
ライセンスMIT。収益化したチャンネルでも無料
必要なものUnreal Engine 5.8(無料)、FaceNinjaのヘッド、MCPを使えるコーディングエージェント
動作環境Windows 10または11、macOS 14以降

写真1枚から、話すヘッドまで。

Creator Kitのデモ動画
AI生成の写真1枚、そこからFaceNinjaが作ったヘッド、そのヘッドがキットの部屋で話す様子を、Unreal 5.8でレンダリングしています。1行目は、無料のKokoroの声と、Epicの無料の音声リップシンク。2行目は、ElevenLabsの声と、有料のRuntime MetaHuman Lip Syncプラグイン。話しているヘッドは、FaceNinjaのARKitヘッド(ブレンドシェイプ52種)に、MetaHuman Creatorのボディと髪を組み合わせたもので、オフラインでレンダリングしています。

この動画に登場する人物はすべて生成されたものです。顔と声は、自分自身のものか、オリジナルのキャラクターを使ってください。

動画をダウンロード(MP4、7.3 MB)

3つの工程、ひと晩で。

  1. あなたのヘッド

    FaceNinjaで写真からヘッドを作り、MetaHuman ZIPをダウンロードします。

  2. エージェントがステージを作る

    キットを解凍し、そのフォルダでコーディングエージェントを開いて、7つのプロンプトを1つずつ貼り付けます。エージェントは、UnrealのMCPサーバーとキットのツールを通じてUnrealを操作します。

  3. あなたが配信する

    iPhoneまたはWebカメラが顔を動かします。セリフを入力すると、アバターが話します。OBSがウィンドウをキャプチャします。

コードを書く必要はありません。どのプロンプトも、確認できるものを出して終わります。

小さなダウンロードに、必要なものを配線済み。

配信用の部屋

ソファ、本棚、観葉植物、やわらかい照明のある、温かみのある小さな部屋。カメラは3台(クローズアップ、バスト、ワイド)で、オンにできるグリーンスクリーンもあります。

あなたのMetaHuman

1つのツールが、MetaHuman ZIPを取り込み、MetaHuman Creatorの顔をそれにぴったり合わせ、いちばん近い髪、眉、まつ毛を選びます。

フェイストラッキング

iPhoneのLive Link Face、またはEpicのWebカメラによるフェイストラッキング。

入力して話す

小さなパネルと、あなたのコンピューター上の音声サーバー。無料のKokoroの声は、最近のグラフィックスカードなら約0.1 sで話し始めます。

OBSにそのまま使える

OBSのウィンドウキャプチャ用に、1920×1080のウィンドウで再生します。自分の背景を使いたいときはグリーンスクリーン。MacではNDI、WindowsではSpoutも選べます。

GLBとFBXのヘッドにも対応

キットは、ヘッドのGLBやFBXも、ARKitブレンドシェイプ52種ごと等身大で取り込み、Unrealで表示するために必要なマテリアル設定も行います。

さらに、エージェント向けのメモ(AGENTS.md)と、Claude Code、Codex、Cursor、VS Code、Gemini CLI用のMCP設定も入っています。

必要なもの。

コンピューター、ソフトウェア、アカウント
項目推奨最小
コンピューターNVIDIA RTX 3070以上のWindows 11、またはM2 Max以降で32 GBメモリのMacRTXカードと16 GBのRAMを備えたPC、またはM1以降で16 GBのMac(フレームレートは下がります)
ディスク空き容量150 GB空き容量100 GB
ソフトウェアUnreal Engine 5.8、OBS、仮想オーディオケーブル(VB-CABLEまたはBlackHole)、コーディングエージェント。プロンプト1が、確認とインストールを一緒に進めます。
アカウントFaceNinjaと、MetaHuman Creatorのリグ用の、無料のEpic Gamesアカウント
オプション無料のLive Link Faceアプリが使えるiPhone 12以降Webカメラ

基本は無料。

無料

  • キット(MITライセンス)
  • Unreal Engine 5.8、MetaHuman Creator、Live Link Face
  • Epicの音声リップシンク
  • OBS、BlackHole、VB-CABLE(寄付は歓迎)
  • Kokoro、Chatterboxの声(コンピューター上で動作)

有料(選んだ場合のみ)

  • FaceNinjaのヘッド(クレジット制、料金)
  • ElevenLabsの声(ご自身のElevenLabsアカウントで、ElevenLabsから文字数に応じて請求されます)
  • FabのRuntime MetaHuman Lip Syncプラグイン:年間$100,000未満のクリエイターは1シートあたり約$280、それ以上は$840

Unrealは、配信や録画した動画からロイヤリティを取りません。他社製品の価格は2026年10月時点のものです。各社のサイトで確認してください。

コピー、貼り付け、確認。

順番に1つずつ貼り付け、エージェントが終わるまで待ちます。どのプロンプトも、確認すべき結果で終わります。

プロンプトは、どの言語版でも英語のままです。エージェントがツール名とファイル名を正確に読む必要があるためです。エージェントとのやり取りは、日本語でかまいません。

01 · 必要なものをインストール

所要時間:20〜90分(ほとんどがダウンロード)

プロンプト · 英語
I am setting up the FaceNinja Creator Kit in this folder. I do not write code, so explain each step in one short
sentence and ask me before anything that needs my password, installs a driver, or changes system settings.

1. Tell me my operating system, CPU, RAM, graphics card and free disk space, and compare them with the
   "What you need" table in GUIDE.md. Warn me if something is below the minimum.
2. Check what is installed and tell me what is missing:
   - Unreal Engine 5.8 (Windows: C:\Program Files\Epic Games\UE_5.8; Mac: /Users/Shared/Epic Games/UE_5.8).
     If it is missing, do not install it yourself: tell me to install Unreal Engine 5.8 from the Epic Games
     Launcher's Library tab (default options), and wait until I say it is done.
   - OBS Studio. Offer to install it (Windows: winget install OBSProject.OBSStudio; Mac: brew install --cask obs).
   - A virtual audio cable. Windows: VB-CABLE from https://vb-audio.com/Cable/ (I run its installer as
     administrator and restart). Mac: brew install --cask blackhole-2ch (it asks for my password).
     Only from these places.
   - uv (https://docs.astral.sh/uv/getting-started/installation/).
3. In tts/, make the voice environment: uv venv -p 3.11, then uv pip install -r requirements-kokoro.txt
   (on a PC with an NVIDIA card add --extra-index-url https://download.pytorch.org/whl/cu128).
4. Run uv run python server.py --list-devices in tts/ and show me the output devices.

End with a checklist: Unreal 5.8, OBS, virtual cable, voice environment, each with a tick or a cross.

表示されるもの:4つのチェックマーク:Unreal 5.8、OBS、ケーブル、音声。

02 · エージェントをUnrealにつなぐ

所要時間:10〜20分

プロンプト · 英語
Open the kit's Unreal project and connect to Unreal's own MCP server.

1. Open FaceNinjaCreatorKit/FaceNinjaCreatorKit.uproject with Unreal Engine 5.8 (Mac: open -a with
   "/Users/Shared/Epic Games/UE_5.8/Engine/Binaries/Mac/UnrealEditor.app" and the project path; Windows:
   "C:\Program Files\Epic Games\UE_5.8\Engine\Binaries\Win64\UnrealEditor.exe" with the project path).
   Tell me the first start takes several minutes while it compiles shaders.
2. The project starts Unreal's MCP server at http://127.0.0.1:8000/mcp. This folder already has the MCP
   settings for you (.mcp.json, .cursor, .vscode, .gemini, .codex). If you cannot see an "unreal-mcp" server,
   tell me how to reload your MCP settings, or add that URL yourself.
3. Wait until the server answers, then list the toolsets. You should find FaceNinjaKitTools. Describe it and
   tell me in one sentence per tool what you can now do for me.

表示されるもの:エージェントがFaceNinjaのツールを一覧表示する。

03 · ステージを作る

所要時間:2〜5分

プロンプト · 英語
Using FaceNinjaKitTools in Unreal, build my streaming stage.

1. Call build_stage. It makes a small room with a sofa, a bookshelf, a plant, lights and three cameras.
2. Take a still from each camera with stage_screenshot (closeup, bust, wide) and show them to me.
3. Ask me which camera I want for streaming and call set_camera with it.

表示されるもの:部屋の静止画が3枚。

04 · FaceNinjaのヘッドを取り込む

所要時間:15〜30分

プロンプト · 英語
Using FaceNinjaKitTools in Unreal, turn my FaceNinja head into a MetaHuman and put it on my stage.
My head ZIP is: <drag the ZIP file here>

1. Call import_head_zip with that path. Tell me which hair, brows and lashes it picked.
2. Tell me that the next step sends my head's shape (not my photos) to Epic's free MetaHuman service, and that
   a browser window may ask me to sign in to my Epic account. Wait for my OK.
3. Call preview_avatar so I can see my head in the room, and show me a stage_screenshot (bust camera).
4. Call rig_head, then download_head_textures. Tell me: "A browser opens Epic's sign-in page. Unreal stops
   answering until you sign in and approve it there; that is normal." Wait until I say I approved it, then
   check head_status every 30 seconds until rigged and high_res_textures are both true.
5. Once rigged: call build_metahuman, then place_avatar.
6. Take a stage_screenshot with the bust camera and show it to me.

表示されるもの:部屋の中のあなたのMetaHuman。

05 · iPhoneかWebカメラをつなぐ

所要時間:10分

プロンプト · 英語
Using FaceNinjaKitTools in Unreal, connect my iPhone's Live Link Face app to my avatar.

1. Call my_ip_address. Tell me where to type it in the app (Settings > Live Link > Add Target, port 14785).
2. Ask me for the phone's IP address (Live Link Face shows it in its settings), then call connect_iphone.
3. Call connect_face with FN_iPhone, then play_in_window.
4. Ask me to smile, blink and turn my head, and whether the avatar follows. Ask before changing any firewall
   setting.

表示されるもの:アバターがあなたの顔を真似る。

06 · 入力して話す

所要時間:10分

プロンプト · 英語
Start the kit's voice server and connect it to my avatar.

1. Ask me which voice I want:
   a. a free preset voice that runs on my computer (Kokoro, default),
   b. my own voice (Chatterbox): ask me to record 10-20 seconds of myself reading any text in a quiet room as
      tts/my_voice.wav, then set it up with requirements-chatterbox.txt,
   c. a studio voice from ElevenLabs: it needs my own ElevenLabs account, costs money per line and sends my text to ElevenLabs.
      Ask me to put my own ElevenLabs API key in the ELEVENLABS_API_KEY environment variable myself; never write it to a file.
2. In tts/ start the server in the background with my cable as --device ("BlackHole" on a Mac, "CABLE Input" on
   Windows):
   a. uv run python server.py --engine kokoro --preset af_heart --device "<cable>"
   b. uv run python server.py --engine chatterbox-turbo --voice my_voice.wav --device "<cable>"
   c. uv run python server.py --engine elevenlabs --voice Rachel --device "<cable>"
3. In Unreal, using FaceNinjaKitTools: voice_status, then connect_voice (it listens on the cable), then
   connect_face with FN_Voice, then play_in_window, then open_talk_panel.
4. Call say with "Hi everyone, welcome back to the stream!" and ask me if the lips moved with the voice.

表示されるもの:入力したセリフを、唇を動かして話す。

07 · OBSで配信する

所要時間:10分

プロンプト · 英語
Help me show my avatar in OBS Studio.

1. In Unreal, using FaceNinjaKitTools: play_in_window (1920x1080). If I want my own background instead of the
   room, call set_green_screen with true first.
2. In OBS add a "Window Capture" (Windows) or "macOS Screen Capture" set to that Unreal window. Tell me the
   clicks; you cannot click in OBS for me.
3. Only with the green screen: add a "Chroma Key" filter (key colour green) and show me where "Similarity" is.
4. Add an "Audio Input Capture" of "CABLE Output" (Windows) or "BlackHole 2ch" (Mac), and set its
   "Audio Monitoring" to "Monitor and Output" so I hear the voice too.

表示されるもの:OBSに映るアバターと、その声。

各ステップと、うまくいかないときの対処は、ZIPに入っているGUIDE.mdにあります。

声は3種類。

入力して話す機能の音声
音声動作場所最初の音費用備考
Kokoro(標準)コンピューター上RTX 5080で約0.08 s、M5 Max Macで0.09 s無料(Apache-2.0)8言語、54種のプリセット音声
自分の声(Chatterbox)コンピューター上RTX 5080またはM5 Max Macで約0.7〜1.1 s無料(MIT)自分の録音10〜20秒から作ります。すべての音声に、生成された音声であることを示す、聞こえない透かしが入ります。
クラウドの声(ElevenLabs)クラウド接続環境しだいです。当社では計測していませんElevenLabsから、ご自身のプランで、文字数に応じて請求入力したセリフはElevenLabsに送られます。ElevenLabsのアカウントとAPIキーは、自分で用意します。

最初の音:セリフを送ってから最初の音声が出るまでの時間。2026年10月に、キットの音声サーバー経由で計測しました。

キットについての質問。

01コードを書く必要はありますか?
いいえ。プロンプトを貼り付けると、エージェントがツールを実行し、結果の画像を見せてくれます。
02Macで使えますか?
はい。M1以降のMacとUnreal 5.8で使えます。Epicのリアルタイム顔ツールは、Unreal 5.8からMacで動きます。
03コンピューターの外に出るデータは?
MetaHuman Creatorがリグを作るとき、ヘッドの形状がEpicに送られます。クラウドの声を選んだ場合は、入力したセリフがElevenLabsに送られます。それ以外は何も出ません。写真も録音も送られません。
04作った動画を販売できますか?
はい。キットはMITライセンスで、Unrealは動画からロイヤリティを取らず、KokoroとChatterboxは商用利用できます。ElevenLabsとFabの部分は、それぞれの規約を確認してください。
05有料のリップシンクプラグインは含まれますか?
いいえ。Fabでシート単位で販売されています。無料の方法では、Epic標準の音声リップシンクを使います。
06アバターをアプリとして配布できますか?
無料のリップシンクでは配布できません。Epicの音声ソースはエディターの中(Play)で動き、VTuberの配信はその状態で行います。パッケージ化したアプリには、有料のプラグインが必要です。
07GLBかFBXしかありません。使えますか?
はい、静止画とアニメーションなら使えます。ファイルの単位はメートルなので、ヘッドは等身大で入ります。キットはマテリアルのUsed with Morph Targetsをオンにするので、ブレンドシェイプが黒く描画されません。リアルタイムの顔と声で動かすのはMetaHumanなので、配信にはMetaHuman ZIPを使ってください。詳しくはこちら:Unrealのメモ EN

ライセンス。

キットはMITライセンスです(ZIPのLICENSE)。部屋のアートはPoly HavenのCC0です。それ以外(Unreal、MetaHuman、OBS、ケーブル、音声、オプションのプラグイン)は、自分でインストールし、それぞれのライセンスに従います。ZIPのTHIRD_PARTY.mdに、リンクつきで一覧があります。

準備はいいですか。まずヘッドを作り、それからキットをダウンロードします。