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üm
0.3.1
İndirme
6,6 MB · zip
Lisans
MIT, para kazanılan kanallar için de ücretsiz
Gerekenler
Unreal Engine 5.8 (ücretsiz), bir FaceNinja kafası ve MCP kullanabilen bir kodlama ajanı
Çalıştığı yer
Windows 10 veya 11, macOS 14 ya da daha yenisi
Bir fotoğraf, sonra konuşan bir kafa.
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.
FaceNinja'da fotoğraflarınızdan bir kafa yapın ve MetaHuman ZIP dosyasını indirin.
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.
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
Önerilen
Asgari
Bilgisayar
NVIDIA RTX 3070 veya üstü bir kartlı Windows 11 ya da M2 Max veya daha yenisi ve 32 GB belleği olan bir Mac
RTX 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ı)
Disk
150 GB boş alan
100 GB boş alan
Yazılım
Unreal 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.
Hesaplar
FaceNinja 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 yenisi
Bir 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
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.
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 ses
Maliyet
Notlar
Kokoro (varsayılan)
Bilgisayarınız
RTX 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ız
RTX 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)
Bulut
Bağlantınıza bağlıdır; biz ölçmedik
Planınız üzerinden, karakter başına ElevenLabs tarafından faturalandırılır
Yazdığı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.
Yüzünüz, sesiniz.
Kendi yüzünüzü ve kendi sesinizi, özgün bir karakteri ya da yazılı olarak kabul etmiş bir kişiyi kullanın. Bir ünlünün, bir yayıncının ya da bir başkasının benzerini yapmayın ve başkasının sesini klonlamayın. Bu, başkasının kimliğine bürünmektir: yasayı ihlal edebilir (kişilik ve tanıtım hakları) ve YouTube'un, Twitch'in ve Epic'in kurallarını ihlal eder.
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ındaEN.
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.