FaceNinja

Creator Kit · VTuber'lar için · ücretsiz

Yüzünüz. Yayınınız.

FaceNinja kafanızı, Unreal Engine 5.8'de küçük bir sahnede sizinle birlikte konuşan ve hareket eden bir MetaHuman'a dönüştürün. Kodlama ajanınız bunu yedi istemden kurar. Siz yazarsınız, o konuşur; siz gülümsersiniz, o da gülümser. Sonra OBS ile yakalarsınız.

Sürüm 0.3.1 · 6,6 MB · MIT lisansı · Windows ve Mac

Betikler ve ajanlar için boyut ve SHA-256: version.json

Kit
Sürüm0.3.1
İndirme6,6 MB · zip
LisansMIT, para kazanılan kanallar için de ücretsiz
GerekenlerUnreal Engine 5.8 (ücretsiz), bir FaceNinja kafası ve MCP kullanabilen bir kodlama ajanı
Çalıştığı yerWindows 10 veya 11, macOS 14 ya da daha yenisi

Bir fotoğraf, sonra konuşan bir kafa.

Creator Kit demo videosu
Yapay zekâyla üretilmiş bir fotoğraf, ondan yapılan FaceNinja kafası, sonra o kafanın kitin odasında konuşması; Unreal 5.8'de render edilmiştir. İlk cümle: Epic'in sesten ücretsiz dudak senkronuyla ücretsiz Kokoro sesi. İkinci cümle: ücretli Runtime MetaHuman Lip Sync eklentisiyle bir ElevenLabs sesi. Konuşan kafa, MetaHuman Creator'ın gövdesi ve saçı üzerindeki FaceNinja'nın ARKit kafasıdır (52 blendshape) ve çevrimdışı render edilmiştir.

Bu videodaki herkes sentetiktir. Kendi yüzünüzü ve sesinizi ya da özgün bir karakter kullanın.

Videoyu indir (MP4, 7,3 MB)

Üç parça, tek akşam.

  1. Kafanız

    FaceNinja'da fotoğraflarınızdan bir kafa yapın ve MetaHuman ZIP dosyasını indirin.

  2. Ajanınız sahneyi kurar

    Kiti açın, kodlama ajanınızı o klasörde başlatın ve yedi istemi tek tek yapıştırın. Ajan, Unreal'ı Unreal'ın kendi MCP sunucusu ve kitin araçlarıyla yönetir.

  3. Siz yayın yaparsınız

    iPhone'unuz ya da web kameranız yüzü hareket ettirir. Bir cümle yazın, avatarınız söylesin. OBS pencereyi yakalar.

Yazılacak kod yok. Her istem, kontrol edebileceğiniz bir şeyle biter.

Küçük bir indirme, her şey bağlı.

Bir yayın odası

Kanepesi, kitaplığı, bitkisi ve yumuşak ışıkları olan sıcak küçük bir oda, üç kamera (yakın çekim, büst, geniş) ve açabileceğiniz bir yeşil perde.

MetaHuman'ınız

Tek bir araç MetaHuman ZIP dosyanızı içe aktarır, MetaHuman Creator'ın yüzünü ona birebir uyumlar ve en yakın saç, kaş ve kirpikleri seçer.

Yüz takibi

iPhone'da Live Link Face ya da Epic'in webcam yüz takibi.

Yazarak konuşma

Bilgisayarınızda küçük bir panel ve bir ses sunucusu. Ücretsiz Kokoro sesi, yeni bir ekran kartında yaklaşık 0,1 s içinde konuşmaya başlar.

OBS'ye hazır

OBS pencere yakalama için 1920×1080'lik bir pencerede oynatın; kendi arka planınızı istediğinizde yeşil perdeyle. Mac'te NDI, Windows'ta Spout seçenektir.

GLB ve FBX kafalar da

Kit, kafanızın GLB veya FBX dosyasını da 52 ARKit blendshape'iyle, gerçek boyutta ve Unreal'ın bunları göstermek için ihtiyaç duyduğu materyal ayarıyla içe aktarır.

Ayrıca Claude Code, Codex, Cursor, VS Code ve Gemini CLI için ajan notları (AGENTS.md) ve MCP ayarları.

Gerekenler.

Bilgisayar, yazılım ve hesaplar
NeÖnerilenAsgari
BilgisayarNVIDIA RTX 3070 veya üstü bir kartlı Windows 11 ya da M2 Max veya daha yenisi ve 32 GB belleği olan bir MacRTX kartlı ve 16 GB RAM'li bir PC ya da M1 veya daha yenisi ve 16 GB belleği olan bir Mac (daha düşük kare hızı)
Disk150 GB boş alan100 GB boş alan
YazılımUnreal Engine 5.8, OBS, bir sanal ses kablosu (VB-CABLE veya BlackHole) ve bir kodlama ajanı. 1. istem bunları sizinle birlikte kontrol eder ve kurar.
HesaplarFaceNinja ve MetaHuman Creator'ın rig'i için ücretsiz bir Epic Games hesabı
İsteğe bağlıÜcretsiz Live Link Face uygulamasıyla iPhone 12 veya daha yenisiBir webcam

Varsayılan olarak ücretsiz.

Ücretsiz

  • Kit (MIT lisansı)
  • Unreal Engine 5.8, MetaHuman Creator ve Live Link Face
  • Epic'in sesten dudak senkronu
  • OBS, BlackHole ve VB-CABLE (bağışlar memnuniyetle karşılanır)
  • Bilgisayarınızda çalışan Kokoro ve Chatterbox sesleri

Ücretli, yalnızca isterseniz

  • FaceNinja kafanız, kredi olarak (fiyatlar)
  • ElevenLabs sesleri; kendi ElevenLabs hesabınızda ve karakter başına ElevenLabs tarafından faturalandırılır
  • Fab'daki Runtime MetaHuman Lip Sync eklentisi: yıllık geliri $100.000 altındaki içerik üreticileri için kullanıcı başına yaklaşık $280, üstündekiler için $840

Unreal, yayınlanan ya da kaydedilen videodan telif almaz. Diğer şirketlerin ürün fiyatları Ekim 2026 itibarıyladır; sitelerinden kontrol edin.

Kopyalayın, yapıştırın, kontrol edin.

Bunları sırayla, tek tek yapıştırın ve ajanınız işi bitirene kadar bekleyin. Her biri görmeniz gereken şeyle biter.

İstemler her dil sürümünde İngilizce kalır, çünkü ajanınızın araç ve dosya adlarını tam olarak alması gerekir. Ajanınızla kendi dilinizde konuşabilirsiniz.

01 · Gerekenleri kurun

Süre: 20–90 dakika, çoğu indirme

İstem · İngilizce
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.

Görmeniz gereken: dört onay işareti: Unreal 5.8, OBS, kablo ve ses.

02 · Ajanınızı Unreal'a bağlayın

Süre: 10–20 dakika

İstem · İngilizce
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.

Görmeniz gereken: ajanınız FaceNinja araçlarını listeler.

03 · Sahnenizi kurun

Süre: 2–5 dakika

İstem · İngilizce
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.

Görmeniz gereken: odanın üç hareketsiz görüntüsü.

04 · FaceNinja kafanızı içe aktarın

Süre: 15–30 dakika

İstem · İngilizce
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.

Görmeniz gereken: MetaHuman'ınız odada.

05 · iPhone ya da webcam'i bağlayın

Süre: 10 dakika

İstem · İngilizce
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.

Görmeniz gereken: avatar yüzünüzü taklit eder.

06 · Yazarak konuşun

Süre: 10 dakika

İstem · İngilizce
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.

Görmeniz gereken: cümlenizi hareket eden dudaklarla söyler.

07 · OBS ile yayına çıkın

Süre: 10 dakika

İstem · İngilizce
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.

Görmeniz gereken: avatarınız sesiyle birlikte OBS'de.

Her adım ve bir şey çalışmadığında ne yapılacağı, zip içindeki GUIDE.md dosyasındadır.

Üç tür ses.

Yazarak konuşma için sesler
SesÇalıştığı yerİlk sesMaliyetNotlar
Kokoro (varsayılan)BilgisayarınızRTX 5080'de yaklaşık 0,08 s, M5 Max Mac'te 0,09 sÜcretsiz (Apache-2.0)8 dilde 54 hazır ses
Kendi sesiniz (Chatterbox)BilgisayarınızRTX 5080'de veya M5 Max Mac'te yaklaşık 0,7–1,1 sÜcretsiz (MIT)Kendi kaydınızın 10–20 saniyesinden. Her klip, onu sentetik olarak işaretleyen duyulmaz bir filigran taşır.
Bulut sesi (ElevenLabs)BulutBağlantınıza bağlıdır; biz ölçmedikPlanınız üzerinden, karakter başına ElevenLabs tarafından faturalandırılırYazdığınız cümleler ElevenLabs'a gider. Kendi ElevenLabs hesabınızı ve API anahtarınızı siz getirirsiniz.

İlk ses: bir cümlenin gönderilmesinden ilk sese kadar geçen süre; Ekim 2026'da kitin ses sunucusu üzerinden ölçülmüştür.

Kitle ilgili sorular.

01Kod yazmam gerekir mi?
Hayır. İstemleri yapıştırırsınız; ajanınız araçları çalıştırır ve size sonucun görüntülerini gösterir.
02Mac'te çalışır mı?
Evet; M1 veya daha yenisi bir Mac'te ve Unreal 5.8 ile. Epic'in gerçek zamanlı yüz araçları Unreal 5.8'den itibaren Mac'lerde çalışır.
03Bilgisayarımdan ne çıkar?
MetaHuman Creator rig'i oluştururken kafanızın şekli Epic'e gider. Bulut sesini seçerseniz yazdığınız cümleler ElevenLabs'a gider. Başka hiçbir şey gitmez: fotoğraf yok, kayıt yok.
04Bununla yaptığım videoları satabilir miyim?
Evet. Kit MIT lisanslıdır, Unreal videodan telif almaz ve Kokoro ile Chatterbox ticari kullanıma izin verir. Kendi parçaları için ElevenLabs ve Fab koşullarını kontrol edin.
05Ücretli dudak senkronu eklentisi dahil mi?
Hayır. Fab'da kullanıcı başına satılır. Ücretsiz yol, Epic'in kendi sesten dudak senkronunu kullanır.
06Avatarımı bir uygulama olarak paylaşabilir miyim?
Ücretsiz dudak senkronuyla olmaz: Epic'in ses kaynağı düzenleyicide (Play) çalışır; bir VTuber yayını da böyle yürür. Paketlenmiş bir uygulama ücretli eklentiyi gerektirir.
07Yalnızca GLB veya FBX dosyam var. Kullanabilir miyim?
Evet, hareketsiz görüntüler ve animasyon için. Dosyalar metre cinsindendir; bu yüzden kafa gerçek boyutta gelir ve kit, blendshape'ler siyah render edilmesin diye materyallerinde Used with Morph Targets ayarını açar. Canlı yüz ve ses MetaHuman'ı yönlendirir; bu yüzden yayın için MetaHuman ZIP dosyasını kullanın. Ayrıntılar Unreal notlarında EN.

Lisanslar.

Kit MIT lisanslıdır (zip içindeki LICENSE). Odanın görselleri Poly Haven'dan CC0'dır. Geri kalan her şeyi (Unreal, MetaHuman, OBS, kablo, sesler, isteğe bağlı eklenti) kendi lisansı altında kendiniz kurarsınız; zip içindeki THIRD_PARTY.md her birini bağlantısıyla listeler.

Hazır mısınız? Önce kafanızı yapın, sonra kiti indirin.