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
Versjon
0.3.1
Nedlasting
6,6 MB · zip
Lisens
MIT, gratis for monetiserte kanaler
Krever
Unreal 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.
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.
Lag et hode fra fotoene dine i FaceNinja og last ned MetaHuman ZIP.
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.
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
Hva
Anbefalt
Minimum
Datamaskin
Windows 11 med NVIDIA RTX 3070 eller bedre, eller en Mac med M2 Max eller nyere og 32 GB minne
En PC med et RTX-kort og 16 GB RAM, eller en Mac med M1 eller nyere og 16 GB (lavere bildefrekvens)
Disk
150 GB ledig
100 GB ledig
Programvare
Unreal Engine 5.8, OBS, en virtuell lydkabel (VB-CABLE eller BlackHole) og en kodeagent. Prompt 1 sjekker og installerer dem sammen med deg.
Kontoer
FaceNinja, og en gratis Epic Games-konto for riggen i MetaHuman Creator
Valgfritt
En iPhone 12 eller nyere med den gratis appen Live Link Face
Et 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
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»
Stemme
Kjører på
Første lyd
Kostnad
Merknader
Kokoro (standard)
Datamaskinen din
Omtrent 0,08 s på en RTX 5080, 0,09 s på en Mac med M5 Max
Gratis (Apache-2.0)
54 forhåndsinnstilte stemmer på 8 språk
Din egen stemme (Chatterbox)
Datamaskinen din
Omtrent 0,7–1,1 s på en RTX 5080 eller en Mac med M5 Max
Gratis (MIT)
Fra 10–20 sekunder av ditt eget opptak. Hvert lydklipp har et uhørbart vannmerke som markerer det som syntetisk.
Skystemme (ElevenLabs)
Skyen
Avhenger av forbindelsen din; ikke målt av oss
Faktureres av ElevenLabs, per tegn, på abonnementet ditt
Replikkene 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.
Ditt ansikt, din stemme.
Bruk ditt eget ansikt og din egen stemme, en original karakter, eller en person som har samtykket skriftlig. Ikke lag en dobbeltgjenger av en kjendis, en streamer eller noen andre, og ikke klon andres stemme. Det er å utgi seg for å være en annen: det kan være ulovlig (personlighets- og publisitetsrettigheter), og det bryter reglene til YouTube, Twitch og Epic.
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-notateneEN.
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.