FaceNinja

Creator Kit · pentru VTuberi · gratuit

Fața dumneavoastră. Streamul dumneavoastră.

Transformați capul FaceNinja într-un MetaHuman care vorbește și se mișcă odată cu dumneavoastră, pe o mică scenă în Unreal Engine 5.8. Agentul de programare îl construiește din șapte prompturi. Scrieți, vorbește; zâmbiți, zâmbește. Apoi îl capturați în OBS.

Versiunea 0.3.1 · 6,6 MB · licență MIT · Windows și Mac

Dimensiunea și SHA-256 pentru scripturi și agenți: version.json

Kitul
Versiune0.3.1
Descărcare6,6 MB · zip
LicențăMIT, gratuit și pentru canale monetizate
CerințeUnreal Engine 5.8 (gratuit), un cap FaceNinja și un agent de programare care poate folosi MCP
Rulează peWindows 10 sau 11, macOS 14 sau mai nou

O fotografie, apoi un cap care vorbește.

Videoclip demo Creator Kit
O fotografie generată cu AI, apoi capul FaceNinja creat din ea, apoi acel cap vorbind în camera kitului, randat în Unreal 5.8. Prima replică: vocea gratuită Kokoro, cu lip sync-ul gratuit din audio de la Epic. A doua replică: o voce ElevenLabs, cu pluginul plătit Runtime MetaHuman Lip Sync. Capul care vorbește este capul ARKit al FaceNinja (52 de blendshape-uri), pe corpul și părul din MetaHuman Creator, randat offline.

Toate persoanele din acest videoclip sunt sintetice. Folosiți propria față și propria voce sau un personaj original.

Descărcați videoclipul (MP4, 7,3 MB)

Trei părți, o seară.

  1. Capul

    Creați în FaceNinja un cap din fotografii și descărcați MetaHuman ZIP.

  2. Agentul construiește scena

    Dezarhivați kitul, deschideți agentul de programare în acel folder și lipiți șapte prompturi, pe rând. Agentul controlează Unreal prin serverul MCP propriu al Unreal și prin uneltele kitului.

  3. Faceți stream

    iPhone-ul sau webcam-ul mișcă fața. Scrieți o replică și avatarul o spune. OBS capturează fereastra.

Nu trebuie să scrieți cod. Fiecare prompt se încheie cu ceva ce puteți verifica.

Descărcare mică, totul conectat.

O cameră de streaming

O cameră mică și primitoare, cu canapea, bibliotecă, o plantă și lumini line, trei camere (prim-plan, bust, plan larg) și un green screen pe care îl puteți activa.

MetaHuman-ul

O singură unealtă importă arhiva MetaHuman ZIP, potrivește exact pe ea fața din MetaHuman Creator și alege părul, sprâncenele și genele cele mai apropiate.

Face tracking

Live Link Face pe un iPhone sau urmărirea feței prin webcam de la Epic.

Scrieți ca să vorbească

Un mic panou și un server de voce pe computer. Vocea gratuită Kokoro începe să vorbească în aproximativ 0,1 s pe o placă video recentă.

Gata pentru OBS

Rulați într-o fereastră de 1920×1080 pentru capturarea ferestrei în OBS, cu green screen atunci când doriți propriul fundal. NDI pe Mac și Spout pe Windows sunt opționale.

Și capete GLB și FBX

Kitul importă și fișierul GLB sau FBX al capului, cu cele 52 de blendshape-uri ARKit, la mărime naturală și cu setarea de material de care Unreal are nevoie ca să le afișeze.

Plus note pentru agenți (AGENTS.md) și setări MCP pentru Claude Code, Codex, Cursor, VS Code și Gemini CLI.

Ce vă trebuie.

Computer, software și conturi
CeRecomandatMinim
ComputerWindows 11 cu NVIDIA RTX 3070 sau mai bun, ori un Mac cu M2 Max sau mai nou și 32 GB de memorieUn PC cu placă RTX și 16 GB de RAM, ori un Mac cu M1 sau mai nou și 16 GB (rată de cadre mai mică)
Disc150 GB liberi100 GB liberi
SoftwareUnreal Engine 5.8, OBS, un cablu audio virtual (VB-CABLE sau BlackHole) și un agent de programare. Promptul 1 le verifică și le instalează împreună cu dumneavoastră.
ConturiFaceNinja și un cont Epic Games gratuit pentru rig-ul din MetaHuman Creator
OpționalUn iPhone 12 sau mai nou, cu aplicația gratuită Live Link FaceO webcam

Gratuit în mod implicit.

Gratuit

  • Kitul (licență MIT)
  • Unreal Engine 5.8, MetaHuman Creator și Live Link Face
  • Lip sync-ul din audio de la Epic
  • OBS, BlackHole și VB-CABLE (donațiile sunt binevenite)
  • Vocile Kokoro și Chatterbox, pe computerul propriu

Cu plată, doar dacă alegeți

  • Capul FaceNinja, în credite (prețuri)
  • Voci ElevenLabs, pe propriul cont ElevenLabs, facturate de ElevenLabs per caracter
  • Pluginul Runtime MetaHuman Lip Sync de pe Fab: aproximativ 280 USD per loc pentru creatorii sub 100.000 USD pe an, 840 USD peste această sumă

Unreal nu percepe redevențe pentru videoclipurile transmise live sau înregistrate. Prețurile produselor altor companii sunt cele din octombrie 2026; verificați site-urile lor.

Copiați, lipiți, verificați.

Lipiți-le în ordine, pe rând, și așteptați până când agentul termină. Fiecare se încheie cu ceea ce ar trebui să vedeți.

Prompturile rămân în engleză în toate versiunile de limbă, pentru că agentul are nevoie de numele exacte ale uneltelor și fișierelor. Puteți vorbi cu agentul în limba dumneavoastră.

01 · Instalați ce vă trebuie

Durată: 20–90 de minute, în mare parte descărcări

Prompt · engleză
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.

Ar trebui să vedeți: patru bife: Unreal 5.8, OBS, cablul și vocea.

02 · Conectați agentul la Unreal

Durată: 10–20 de minute

Prompt · engleză
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.

Ar trebui să vedeți: agentul listează uneltele FaceNinja.

03 · Construiți scena

Durată: 2–5 minute

Prompt · engleză
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.

Ar trebui să vedeți: trei cadre statice ale camerei.

04 · Aduceți capul FaceNinja

Durată: 15–30 de minute

Prompt · engleză
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.

Ar trebui să vedeți: MetaHuman-ul în cameră.

05 · Conectați iPhone sau webcam

Durată: 10 minute

Prompt · engleză
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.

Ar trebui să vedeți: avatarul vă copiază fața.

06 · Scrieți ca să vorbească

Durată: 10 minute

Prompt · engleză
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.

Ar trebui să vedeți: spune replica cu buzele în mișcare.

07 · Transmiteți live cu OBS

Durată: 10 minute

Prompt · engleză
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.

Ar trebui să vedeți: avatarul în OBS, cu vocea lui.

Fiecare pas, cu ce trebuie făcut când ceva nu funcționează, se găsește în GUIDE.md din arhivă.

Trei feluri de voce.

Voci pentru „Scrieți ca să vorbească”
VoceRulează pePrimul sunetCostNote
Kokoro (implicit)Computerul propriuAproximativ 0,08 s pe un RTX 5080, 0,09 s pe un Mac M5 MaxGratuit (Apache-2.0)54 de voci predefinite în 8 limbi
Propria voce (Chatterbox)Computerul propriuAproximativ 0,7–1,1 s pe un RTX 5080 sau un Mac M5 MaxGratuit (MIT)Din 10–20 de secunde ale propriei înregistrări. Fiecare clip poartă un filigran inaudibil care îl marchează ca sintetic.
Voce în cloud (ElevenLabs)În cloudDepinde de conexiune; nu l-am măsurat noiFacturat de ElevenLabs, per caracter, conform planului alesReplicile scrise ajung la ElevenLabs. Folosiți propriul cont ElevenLabs și propria cheie API.

Primul sunet: timpul de la trimiterea unei replici până la primul audio, măsurat prin serverul de voce al kitului în octombrie 2026.

Întrebări despre kit.

01Trebuie să scriu cod?
Nu. Lipiți prompturi; agentul rulează uneltele și vă arată imagini cu rezultatul.
02Funcționează pe Mac?
Da, pe un Mac cu M1 sau mai nou și Unreal 5.8. Uneltele Epic pentru fețe în timp real rulează pe Mac începând cu Unreal 5.8.
03Ce pleacă de pe computerul meu?
Forma capului ajunge la Epic atunci când MetaHuman Creator construiește rig-ul. Dacă alegeți vocea în cloud, replicile pe care le scrieți ajung la ElevenLabs. Nimic altceva: nicio fotografie, nicio înregistrare.
04Pot vinde videoclipuri realizate cu el?
Da. Kitul este MIT, Unreal nu percepe redevențe pentru video, iar Kokoro și Chatterbox permit utilizarea comercială. Verificați termenii ElevenLabs și Fab pentru părțile lor.
05Este inclus pluginul plătit de lip sync?
Nu. Se vinde per loc pe Fab. Varianta gratuită folosește lip sync-ul din audio de la Epic.
06Pot distribui avatarul ca aplicație?
Nu cu lip sync-ul gratuit: sursa audio de la Epic funcționează în editor (Play), așa rulează un stream de VTuber. O aplicație împachetată are nevoie de pluginul plătit.
07Am doar GLB sau FBX. Le pot folosi?
Da, pentru imagini statice și animație. Fișierele sunt în metri, așa că capul intră la mărime naturală, iar kitul activează Used with Morph Targets pe materialele sale, ca blendshape-urile să nu fie randate negre. Fața și vocea în timp real controlează MetaHuman-ul, așa că pentru streaming folosiți MetaHuman ZIP. Mai multe în notele Unreal EN.

Licențe.

Kitul este MIT (LICENSE în arhivă). Elementele grafice ale camerei sunt CC0, de la Poly Haven. Tot restul (Unreal, MetaHuman, OBS, cablul, vocile, pluginul opțional) se instalează separat, sub licența proprie; THIRD_PARTY.md din arhivă le listează pe fiecare, cu linkul lui.

Gata? Creați-vă capul, apoi descărcați kitul.