FaceNinja

Creator Kit · for VTubere · gratis

Ansiktet ditt. Streamen din.

Gjør FaceNinja-hodet ditt om til en MetaHuman som snakker og beveger seg sammen med deg, på en liten scene i Unreal Engine 5.8. Kodeagenten din bygger den ut fra sju prompter. Du skriver, den snakker; du smiler, den smiler. Deretter fanger du den i OBS.

Versjon 0.3.1 · 6,6 MB · MIT-lisens · Windows og Mac

Størrelse og SHA-256 for skript og agenter: version.json

Kitet
Versjon0.3.1
Nedlasting6,6 MB · zip
LisensMIT, gratis for monetiserte kanaler
KreverUnreal Engine 5.8 (gratis), et FaceNinja-hode og en kodeagent som kan bruke MCP
Kjører påWindows 10 eller 11, macOS 14 eller nyere

Ett foto, så et hode som snakker.

Demovideo av Creator Kit
Ett AI-generert foto, så FaceNinja-hodet laget fra det, så det hodet som snakker i kitets rom, rendret i Unreal 5.8. Første replikk: den gratis Kokoro-stemmen med Epics gratis lipsync fra lyd. Andre replikk: en ElevenLabs-stemme med den betalte pluginen Runtime MetaHuman Lip Sync. Det snakkende hodet er FaceNinjas ARKit-hode (52 blendshapes) på kroppen og håret fra MetaHuman Creator, rendret offline.

Alle i denne videoen er syntetiske. Bruk ditt eget ansikt og din egen stemme, eller en original karakter.

Last ned videoen (MP4, 7,3 MB)

Tre deler, én kveld.

  1. Hodet ditt

    Lag et hode fra fotoene dine i FaceNinja og last ned MetaHuman ZIP.

  2. Agenten din bygger scenen

    Pakk ut kitet, åpne kodeagenten din i den mappen og lim inn sju prompter, én om gangen. Agenten styrer Unreal gjennom Unreals egen MCP-server og verktøyene i kitet.

  3. Du streamer

    iPhonen eller webkameraet ditt styrer ansiktet. Skriv en replikk, så sier avataren din den. OBS fanger vinduet.

Du trenger ikke skrive kode. Hver prompt ender med noe du kan sjekke.

Liten nedlasting, alt er koblet opp.

Et streamingrom

Et lunt lite rom med sofa, bokhylle, en plante og myke lys, tre kameraer (nærbilde, byste, vidvinkel) og en greenscreen du kan slå på.

Din MetaHuman

Ett verktøy importerer MetaHuman ZIP-en din, tilpasser ansiktet i MetaHuman Creator nøyaktig til hodet og velger nærmeste hår, bryn og vipper.

Ansiktssporing

Live Link Face på en iPhone, eller Epics ansiktssporing med webkamera.

Skriv for å snakke

Et lite panel og en stemmeserver på datamaskinen din. Den gratis Kokoro-stemmen begynner å snakke etter omtrent 0,1 s på et nyere grafikkort.

Klar for OBS

Spill i et 1920×1080-vindu for vindusopptak i OBS, med greenscreen når du vil ha din egen bakgrunn. NDI på Mac og Spout på Windows er alternativer.

Også GLB- og FBX-hoder

Kitet henter også inn GLB- eller FBX-filen til hodet ditt med 52 ARKit-blendshapes, i naturlig størrelse og med materialinnstillingen Unreal trenger for å vise dem.

Pluss agentnotater (AGENTS.md) og MCP-innstillinger for Claude Code, Codex, Cursor, VS Code og Gemini CLI.

Dette trenger du.

Datamaskin, programvare og kontoer
HvaAnbefaltMinimum
DatamaskinWindows 11 med NVIDIA RTX 3070 eller bedre, eller en Mac med M2 Max eller nyere og 32 GB minneEn PC med et RTX-kort og 16 GB RAM, eller en Mac med M1 eller nyere og 16 GB (lavere bildefrekvens)
Disk150 GB ledig100 GB ledig
ProgramvareUnreal Engine 5.8, OBS, en virtuell lydkabel (VB-CABLE eller BlackHole) og en kodeagent. Prompt 1 sjekker og installerer dem sammen med deg.
KontoerFaceNinja, og en gratis Epic Games-konto for riggen i MetaHuman Creator
ValgfrittEn iPhone 12 eller nyere med den gratis appen Live Link FaceEt webkamera

Gratis som standard.

Gratis

  • Kitet (MIT-lisens)
  • Unreal Engine 5.8, MetaHuman Creator og Live Link Face
  • Epics lipsync fra lyd
  • OBS, BlackHole og VB-CABLE (donasjoner mottas med takk)
  • Stemmene Kokoro og Chatterbox, på datamaskinen din

Betalt, bare hvis du velger det

  • FaceNinja-hodet ditt, i kreditter (priser)
  • ElevenLabs-stemmer, på din egen ElevenLabs-konto og fakturert av ElevenLabs per tegn
  • Pluginen Runtime MetaHuman Lip Sync på Fab: omtrent 280 USD per plass for skapere under 100 000 USD i året, 840 USD over

Unreal tar ingen royalty på streamet eller innspilt video. Priser på andre selskapers produkter per oktober 2026; sjekk nettstedene deres.

Kopier, lim inn, sjekk.

Lim dem inn i rekkefølge, én om gangen, og vent til agenten din er ferdig. Hver av dem ender med det du skal se.

Promptene står på engelsk på alle språkversjoner, fordi agenten din trenger verktøy- og filnavnene nøyaktig. Du kan snakke med agenten din på ditt eget språk.

01 · Installer det du trenger

Tid: 20–90 minutter, mest nedlastinger

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

Du skal se: fire hakemerker: Unreal 5.8, OBS, kabelen og stemmen.

02 · Koble agenten din til Unreal

Tid: 10–20 minutter

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

Du skal se: agenten din lister opp FaceNinja-verktøyene.

03 · Bygg scenen din

Tid: 2–5 minutter

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

Du skal se: tre stillbilder av rommet.

04 · Hent inn FaceNinja-hodet ditt

Tid: 15–30 minutter

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

Du skal se: din MetaHuman i rommet.

05 · Koble til iPhone eller webkamera

Tid: 10 minutter

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

Du skal se: avataren etterligner ansiktet ditt.

06 · Skriv for å snakke

Tid: 10 minutter

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

Du skal se: den sier replikken din med lepper i bevegelse.

07 · Gå live med OBS

Tid: 10 minutter

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

Du skal se: avataren din i OBS, med stemme.

Alle trinn, med hva du gjør når noe ikke fungerer, står i GUIDE.md i zip-filen.

Tre typer stemme.

Stemmer for «Skriv for å snakke»
StemmeKjører påFørste lydKostnadMerknader
Kokoro (standard)Datamaskinen dinOmtrent 0,08 s på en RTX 5080, 0,09 s på en Mac med M5 MaxGratis (Apache-2.0)54 forhåndsinnstilte stemmer på 8 språk
Din egen stemme (Chatterbox)Datamaskinen dinOmtrent 0,7–1,1 s på en RTX 5080 eller en Mac med M5 MaxGratis (MIT)Fra 10–20 sekunder av ditt eget opptak. Hvert lydklipp har et uhørbart vannmerke som markerer det som syntetisk.
Skystemme (ElevenLabs)SkyenAvhenger av forbindelsen din; ikke målt av ossFaktureres av ElevenLabs, per tegn, på abonnementet dittReplikkene du skriver, sendes til ElevenLabs. Du tar med din egen ElevenLabs-konto og API-nøkkel.

Første lyd: tiden fra en replikk sendes til første lyd, målt gjennom stemmeserveren i kitet i oktober 2026.

Spørsmål om kitet.

01Må jeg kunne kode?
Nei. Du limer inn prompter; agenten din kjører verktøyene og viser deg bilder av resultatet.
02Fungerer det på Mac?
Ja, på en Mac med M1 eller nyere og Unreal 5.8. Epics ansiktsverktøy i sanntid kjører på Mac fra og med Unreal 5.8.
03Hva forlater datamaskinen min?
Formen på hodet ditt sendes til Epic når MetaHuman Creator bygger riggen. Hvis du velger skystemmen, sendes replikkene du skriver, til ElevenLabs. Ingenting annet: ingen foto, ingen opptak.
04Kan jeg selge videoer laget med det?
Ja. Kitet har MIT-lisens, Unreal tar ingen royalty på video, og Kokoro og Chatterbox tillater kommersiell bruk. Sjekk vilkårene til ElevenLabs og Fab for deres deler.
05Følger den betalte lipsync-pluginen med?
Nei. Den selges per plass på Fab. Den gratis løsningen bruker Epics egen lipsync fra lyd.
06Kan jeg dele avataren min som en app?
Ikke med den gratis lipsyncen: Epics lydkilde fungerer i editoren (Play), og det er slik en VTuber-stream kjører. En pakket app krever den betalte pluginen.
07Jeg har bare GLB- eller FBX-filen. Kan jeg bruke den?
Ja, for stillbilder og animasjon. Filene er i meter, så hodet kommer inn i naturlig størrelse, og kitet slår på Used with Morph Targets på materialene, slik at blendshapes ikke rendres svarte. Live ansiktssporing og stemme styrer MetaHuman, så bruk MetaHuman ZIP til streaming. Mer i Unreal-notatene EN.

Lisenser.

Kitet har MIT-lisens (LICENSE i zip-filen). Kunsten i rommet er CC0 fra Poly Haven. Alt annet (Unreal, MetaHuman, OBS, kabelen, stemmene, den valgfrie pluginen) installerer du selv, under sin egen lisens; THIRD_PARTY.md i zip-filen lister opp hver enkelt med lenke.

Klar? Lag hodet ditt, og last deretter ned kitet.