Gør dit FaceNinja-hoved til en MetaHuman, der taler og bevæger sig med dig, på en lille scene i Unreal Engine 5.8. Din kodeagent bygger den ud fra syv prompts. Du skriver, den taler; du smiler, den smiler. Så optager du den i OBS.
Version 0.3.1 · 6,6 MB · MIT-licens · Windows og Mac
Størrelse og SHA-256 til scripts og agenter: version.json
Kittet
Version
0.3.1
Download
6,6 MB · zip
Licens
MIT, gratis til monetiserede kanaler
Kræver
Unreal Engine 5.8 (gratis), et FaceNinja-hoved og en kodeagent, der kan bruge MCP
Kører på
Windows 10 eller 11, macOS 14 eller nyere
Ét foto, så et hoved, der taler.
Ét AI-genereret foto, så FaceNinja-hovedet lavet ud fra det, så det hoved, der taler i kittets rum, renderet i Unreal 5.8. Første replik: den gratis Kokoro-stemme med Epics gratis læbesynkronisering fra lyd. Anden replik: en ElevenLabs-stemme med det betalte plugin Runtime MetaHuman Lip Sync. Det talende hoved er FaceNinjas ARKit-hoved (52 blendshapes) på MetaHuman Creators krop og hår, renderet offline.
Alle i denne video er syntetiske. Brug dit eget ansigt og din egen stemme, eller en original karakter.
Lav et hoved ud fra dine fotos i FaceNinja, og hent MetaHuman ZIP-filen.
Din agent bygger scenen
Pak kittet ud, åbn din kodeagent i den mappe, og indsæt syv prompts, én ad gangen. Agenten styrer Unreal gennem Unreals egen MCP-server og kittets værktøjer.
Du streamer
Din iPhone eller webcam bevæger ansigtet. Skriv en replik, og din avatar siger den. OBS optager vinduet.
Ingen kode at skrive. Hver prompt ender med noget, du kan kontrollere.
Lille download, alt koblet sammen.
Et streamingrum
Et varmt lille rum med sofa, reol, plante og blødt lys, tre kameraer (close-up, buste, vidvinkel) og en greenscreen, du kan tænde for.
Din MetaHuman
Ét værktøj importerer din MetaHuman ZIP, tilpasser MetaHuman Creators ansigt præcist til den og vælger det nærmeste hår, øjenbryn og øjenvipper.
Ansigtssporing
Live Link Face på en iPhone eller Epics webcam-ansigtssporing.
Skriv for at tale
Et lille panel og en stemmeserver på din computer. Den gratis Kokoro-stemme begynder at tale på cirka 0,1 s på et nyere grafikkort.
Klar til OBS
Spil i et 1920×1080-vindue til OBS-vinduesoptagelse, med en greenscreen, når du vil have din egen baggrund. NDI på Mac og Spout på Windows er muligheder.
Også GLB- og FBX-hoveder
Kittet importerer også dit hoveds GLB eller FBX med dets 52 ARKit-blendshapes, i naturlig størrelse og med den materialeindstilling, Unreal skal bruge for at vise dem.
Plus agentnoter (AGENTS.md) og MCP-indstillinger til Claude Code, Codex, Cursor, VS Code og Gemini CLI.
Det skal du bruge.
Computer, software og konti
Hvad
Anbefalet
Minimum
Computer
Windows 11 med et NVIDIA RTX 3070 eller bedre, eller en Mac med M2 Max eller nyere og 32 GB hukommelse
En pc med et RTX-kort og 16 GB RAM, eller en Mac med M1 eller nyere og 16 GB (lavere billedhastighed)
Disk
150 GB ledigt
100 GB ledigt
Software
Unreal Engine 5.8, OBS, et virtuelt lydkabel (VB-CABLE eller BlackHole) og en kodeagent. Prompt 1 tjekker og installerer dem sammen med dig.
Konti
FaceNinja og en gratis Epic Games-konto til MetaHuman Creators rig
Valgfrit
En iPhone 12 eller nyere med den gratis app Live Link Face
Et webcam
Gratis som standard.
Gratis
Kittet (MIT-licens)
Unreal Engine 5.8, MetaHuman Creator og Live Link Face
Epics læbesynkronisering fra lyd
OBS, BlackHole og VB-CABLE (donationer er velkomne)
ElevenLabs-stemmer, på din egen ElevenLabs-konto og faktureret af ElevenLabs pr. tegn
Pluginet Runtime MetaHuman Lip Sync på Fab: cirka 280 US$ pr. plads for skabere under 100.000 US$ om året, 840 US$ over
Unreal tager ingen royalty på streamet eller optaget video. Priser på andre virksomheders produkter pr. oktober 2026; tjek deres sider.
Kopiér, indsæt, kontrollér.
Indsæt dem i rækkefølge, én ad gangen, og vent, til din agent er færdig. Hver ender med det, du bør se.
Prompterne er på engelsk i alle sprogversioner, fordi din agent skal bruge værktøjs- og filnavnene præcist. Du kan tale med din agent på dit eget sprog.
01 · Installér det, du skal bruge
Tid: 20–90 minutter, mest downloads
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 bør se: fire flueben: Unreal 5.8, OBS, kablet og stemmen.
02 · Forbind din agent 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 bør se: din agent oplister FaceNinja-værktøjerne.
03 · Byg din scene
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 bør se: tre stillbilleder af rummet.
04 · Importér dit FaceNinja-hoved
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 bør se: din MetaHuman i rummet.
05 · Forbind din iPhone eller webcam
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 bør se: avataren kopierer dit ansigt.
06 · Skriv for at tale
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 bør se: den siger din replik med bevægelige læber.
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 bør se: din avatar i OBS, med sin stemme.
Hvert trin, med hvad du gør, når noget ikke virker, står i GUIDE.md i zip-filen.
Tre slags stemmer.
Stemmer til skriv-for-at-tale
Stemme
Kører på
Første lyd
Pris
Noter
Kokoro (standard)
Din computer
Cirka 0,08 s på et RTX 5080, 0,09 s på en M5 Max-Mac
Gratis (Apache-2.0)
54 faste stemmer på 8 sprog
Din egen stemme (Chatterbox)
Din computer
Cirka 0,7–1,1 s på et RTX 5080 eller en M5 Max-Mac
Gratis (MIT)
Ud fra 10–20 sekunder af din egen optagelse. Hvert klip bærer et uhørligt vandmærke, der markerer det som syntetisk.
Skystemme (ElevenLabs)
Skyen
Afhænger af din forbindelse; ikke målt af os
Faktureret af ElevenLabs, pr. tegn, på din plan
Dine indtastede replikker sendes til ElevenLabs. Du medbringer din egen ElevenLabs-konto og API-nøgle.
Første lyd: tiden fra en replik sendes til den første lyd, målt gennem kittets stemmeserver i oktober 2026.
Dit ansigt, din stemme.
Brug dit eget ansigt og din egen stemme, en original karakter eller en person, der har givet skriftligt samtykke. Lav ikke en kopi af en kendt person, en streamer eller nogen anden, og klon ikke andres stemme. Det er efterligning: det kan være ulovligt (personlighedsrettigheder og retten til eget navn og billede), og det bryder YouTubes, Twitchs og Epics regler.
Spørgsmål om kittet.
01Skal jeg kunne kode?
Nej. Du indsætter prompts; din agent kører værktøjerne og viser dig billeder af resultatet.
02Virker det på en Mac?
Ja, på en Mac med M1 eller nyere og Unreal 5.8. Epics realtidsværktøjer til ansigter kører på Mac fra Unreal 5.8.
03Hvad forlader min computer?
Dit hoveds form går til Epic, når MetaHuman Creator bygger riggen. Hvis du vælger skystemmen, går de replikker, du skriver, til ElevenLabs. Intet andet: ingen fotos, ingen optagelser.
04Må jeg sælge videoer lavet med det?
Ja. Kittet er MIT, Unreal tager ingen royalty på video, og Kokoro og Chatterbox tillader kommerciel brug. Tjek ElevenLabs' og Fabs vilkår for deres dele.
05Er det betalte lip sync-plugin inkluderet?
Nej. Det sælges pr. plads på Fab. Den gratis vej bruger Epics egen læbesynkronisering fra lyd.
06Kan jeg dele min avatar som en app?
Ikke med den gratis læbesynkronisering: Epics lydkilde virker i editoren (Play), og sådan kører en VTuber-stream. En pakket app kræver det betalte plugin.
07Jeg har kun GLB eller FBX. Kan jeg bruge det?
Ja, til stillbilleder og animation. Filerne er i meter, så hovedet kommer ind i naturlig størrelse, og kittet slår Used with Morph Targets til på sine materialer, så blendshapes ikke renderes sorte. Live ansigt og stemme styrer MetaHuman, så brug MetaHuman ZIP til streaming. Mere i Unreal-noterneEN.
Licenser.
Kittet er MIT (LICENSE i zip-filen). Rummets kunst er CC0 fra Poly Haven. Alt andet (Unreal, MetaHuman, OBS, kablet, stemmerne, det valgfrie plugin) installerer du selv, under dets egen licens; THIRD_PARTY.md i zip-filen oplister hver enkelt med dens link.