FaceNinja

Creator Kit · VTuberekhez · ingyenes

Az arcod. A streamed.

A FaceNinja-fejedből MetaHuman lesz, amely veled együtt beszél és mozog, egy kis színpadon az Unreal Engine 5.8-ban. A kódoló ügynököd hét promptból építi fel. Te gépelsz, ő beszél; te mosolyogsz, ő is mosolyog. Aztán az OBS-ben rögzíted.

Verzió: 0.3.1 · 6,6 MB · MIT-licenc · Windows és Mac

Méret és SHA-256 szkriptekhez és ügynököknek: version.json

A kit
Verzió0.3.1
Letöltés6,6 MB · zip
LicencMIT, monetizált csatornákon is ingyenes
SzükségesUnreal Engine 5.8 (ingyenes), egy FaceNinja-fej és egy MCP-t használni tudó kódoló ügynök
PlatformWindows 10 vagy 11, macOS 14 vagy újabb

Egy fotó, aztán egy fej, ami beszél.

Creator Kit demóvideó
Egy AI-val generált fotó, aztán a belőle készült FaceNinja-fej, aztán ez a fej beszél a kit szobájában, Unreal 5.8-ban renderelve. Első mondat: az ingyenes Kokoro hang, mellé az Epic ingyenes hangalapú lip syncje. Második mondat: egy ElevenLabs hang, mellé a fizetős Runtime MetaHuman Lip Sync plugin. A beszélő fej a FaceNinja ARKit-feje (52 blendshape) a MetaHuman Creator testén és haján, offline renderelve.

Ebben a videóban mindenki szintetikus. Használd a saját arcodat és hangodat, vagy egy eredeti karaktert.

Videó letöltése (MP4, 7,3 MB)

Három rész, egy este.

  1. A fejed

    Készíts fejet a fotóidból a FaceNinja webalkalmazásában, és töltsd le a MetaHuman ZIP-et.

  2. Az ügynököd megépíti a színpadot

    Csomagold ki a kitet, nyisd meg benne a kódoló ügynöködet, és illessz be hét promptot, egyenként. Az ügynök az Unreal saját MCP-szerverén és a kit eszközein keresztül vezérli az Unrealt.

  3. Te streamelsz

    Az iPhone-od vagy a webkamerád mozgatja az arcot. Gépelj be egy mondatot, és az avatárod kimondja. Az OBS rögzíti az ablakot.

Nem kell kódot írnod. Minden prompt valamivel zárul, amit ellenőrizhetsz.

Kis letöltés, minden bekötve.

Streamszoba

Egy meleg hangulatú kis szoba kanapéval, könyvespolccal, növénnyel és lágy fényekkel, három kamera (közeli, mellkép, totál) és egy bekapcsolható green screen.

A MetaHumanod

Egy eszköz importálja a MetaHuman ZIP-et, pontosan ráilleszti a MetaHuman Creator arcát, és kiválasztja a legközelebbi hajat, szemöldököt és szempillát.

Arckövetés

Live Link Face iPhone-on, vagy az Epic webkamerás arckövetése.

Gépelj, és beszél

Egy kis panel és egy hangszerver a gépeden. Az ingyenes Kokoro hang körülbelül 0,1 s alatt megszólal egy friss videókártyán.

Kész az OBS-hez

Játssz le egy 1920×1080-as ablakban az OBS ablakrögzítéséhez, green screennel, ha saját hátteret akarsz. Macen az NDI, Windowson a Spout is használható.

GLB- és FBX-fejek is

A kit a fejed GLB- vagy FBX-fájlját is behozza az 52 ARKit blendshape-pel, élethű méretben, és azzal az anyagbeállítással, amelyet az Unreal a megjelenítésükhöz igényel.

Plusz ügynökjegyzetek (AGENTS.md) és MCP-beállítások Claude Code, Codex, Cursor, VS Code és Gemini CLI számára.

Amire szükséged van.

Számítógép, szoftver és fiókok
MiAjánlottMinimum
SzámítógépWindows 11 NVIDIA RTX 3070-nel vagy jobbal, vagy Mac M2 Max-szal vagy újabbal és 32 GB memóriávalRTX kártyás PC 16 GB RAM-mal, vagy M1-es vagy újabb Mac 16 GB-tal (alacsonyabb képkockasebesség)
Lemez150 GB szabad hely100 GB szabad hely
SzoftverUnreal Engine 5.8, OBS, egy virtuális audiokábel (VB-CABLE vagy BlackHole) és egy kódoló ügynök. Az 1. prompt ellenőrzi és veled együtt telepíti őket.
FiókokFaceNinja, és egy ingyenes Epic Games-fiók a MetaHuman Creator rigjéhez
OpcionálisEgy iPhone 12 vagy újabb az ingyenes Live Link Face alkalmazássalEgy webkamera

Alapból ingyenes.

Ingyenes

  • A kit (MIT-licenc)
  • Unreal Engine 5.8, MetaHuman Creator és Live Link Face
  • Az Epic hangalapú lip syncje
  • OBS, BlackHole és VB-CABLE (az adományokat szívesen fogadják)
  • A Kokoro és a Chatterbox hang, a saját gépeden

Fizetős, csak ha te választod

  • A FaceNinja-fejed, kreditben (árak)
  • ElevenLabs hangok, a saját ElevenLabs-fiókodon, az ElevenLabs számlázza karakterenként
  • A Runtime MetaHuman Lip Sync plugin a Fabon: körülbelül 280 USD felhasználónként az évi 100 000 USD alatti bevételű alkotóknak, fölötte 840 USD

Az Unreal nem kér jogdíjat a streamelt vagy rögzített videókból. Más cégek termékeinek árai 2026. októberi állapot szerint; ellenőrizd az oldalaikon.

Másold, illeszd be, ellenőrizd.

Illeszd be őket sorrendben, egyenként, és várd meg, amíg az ügynököd végez. Mindegyik azzal zárul, amit látnod kell.

A promptok minden nyelvi változaton angolul maradnak, mert az ügynöknek pontosan kell ismernie az eszköz- és fájlneveket. Az ügynökhöz a saját nyelveden szólhatsz.

01 · Telepítsd, amire szükséged van

Idő: 20–90 perc, főleg letöltés

Prompt · angolul
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.

Ezt kell látnod: négy pipa: Unreal 5.8, OBS, a kábel és a hang.

02 · Ügynök és Unreal összekötése

Idő: 10–20 perc

Prompt · angolul
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.

Ezt kell látnod: az ügynököd felsorolja a FaceNinja eszközeit.

03 · Építsd fel a színpadod

Idő: 2–5 perc

Prompt · angolul
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.

Ezt kell látnod: három állókép a szobáról.

04 · Hozd be a FaceNinja-fejed

Idő: 15–30 perc

Prompt · angolul
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.

Ezt kell látnod: a MetaHumanod a szobában.

05 · iPhone vagy webkamera bekötése

Idő: 10 perc

Prompt · angolul
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.

Ezt kell látnod: az avatár lemásolja az arcod.

06 · Gépelj, és beszél

Idő: 10 perc

Prompt · angolul
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.

Ezt kell látnod: kimondja a mondatodat, mozgó ajkakkal.

07 · Élő adás OBS-sel

Idő: 10 perc

Prompt · angolul
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.

Ezt kell látnod: az avatárod az OBS-ben, a hangjával.

Minden lépés, és hogy mit tegyél, ha valami nem működik, a zip GUIDE.md fájljában van.

Háromféle hang.

Hangok a gépelj-és-beszél módhoz
HangHol futElső hangKöltségMegjegyzés
Kokoro (alap)A gépedenKörülbelül 0,08 s RTX 5080-on, 0,09 s M5 Max MacenIngyenes (Apache-2.0)54 előre beállított hang, 8 nyelven
Saját hangod (Chatterbox)A gépedenKörülbelül 0,7–1,1 s RTX 5080-on vagy M5 Max MacenIngyenes (MIT)10–20 másodpercnyi saját felvételből. Minden klip hallhatatlan vízjelet hordoz, amely szintetikusként jelöli meg.
Felhőalapú hang (ElevenLabs)A felhőbenA kapcsolatodtól függ; mi nem mértükAz ElevenLabs számlázza karakterenként, a csomagod szerintA begépelt mondataid az ElevenLabs felé mennek. Saját ElevenLabs-fiókot és API-kulcsot kell hoznod.

Első hang: a mondat elküldésétől az első hangig eltelt idő, a kit hangszerverén keresztül mérve, 2026 októberében.

Kérdések a kitről.

01Kell kódolnom?
Nem. Promptokat illesztesz be; az ügynököd futtatja az eszközöket, és képeket mutat az eredményről.
02Működik Macen?
Igen, M1-es vagy újabb Macen és Unreal 5.8-cal. Az Epic valós idejű arceszközei az Unreal 5.8-tól futnak Macen.
03Mi hagyja el a gépemet?
A fejed alakja az Epichez kerül, amikor a MetaHuman Creator felépíti a rigot. Ha a felhőalapú hangot választod, a begépelt mondataid az ElevenLabshoz kerülnek. Más semmi: nincsenek fotók, nincsenek felvételek.
04Eladhatok vele készült videókat?
Igen. A kit MIT-licencű, az Unreal nem kér jogdíjat a videóra, a Kokoro és a Chatterbox pedig engedélyezi a kereskedelmi használatot. Az ElevenLabs és a Fab részeire nézd meg a feltételeiket.
05Benne van a fizetős lip sync plugin?
Nem. Felhasználónként árulják a Fabon. Az ingyenes út az Epic saját hangalapú lip syncjét használja.
06Megoszthatom az avatáromat alkalmazásként?
Az ingyenes lip synckel nem: az Epic hangforrása a szerkesztőben (Play) működik, így fut egy VTuber-stream. A csomagolt alkalmazáshoz a fizetős plugin kell.
07Csak GLB vagy FBX fájlom van. Használhatom?
Igen, állóképekhez és animációhoz. A fájlok méterben vannak, így a fej élethű méretben jön be, és a kit bekapcsolja az anyagain a Used with Morph Targets beállítást, hogy a blendshape-ek ne rendereljenek feketén. A MetaHuman-karaktert vezérli az élő arc és hang, ezért streameléshez a MetaHuman ZIP-et használd. Több az Unreal-jegyzetekben EN.

Licencek.

A kit MIT-licencű (a zipben a LICENSE). A szoba grafikái CC0-k a Poly Havenről. Minden mást (Unreal, MetaHuman, OBS, a kábel, a hangok, az opcionális plugin) te telepítesz, a saját licencük alatt; a zipben a THIRD_PARTY.md mindegyiket felsorolja a linkjével.

Kész vagy? Készítsd el a fejed, aztán töltsd le a kitet.