Convierte tu cabeza FaceNinja en un MetaHuman que habla y se mueve contigo, en un pequeño escenario de Unreal Engine 5.8. Tu agente de programación lo construye a partir de siete prompts. Tú escribes, él habla; tú sonríes, él sonríe. Luego lo capturas en OBS.
Versión 0.3.1 · 6,6 MB · licencia MIT · Windows y Mac
Tamaño y SHA-256 para scripts y agentes: version.json
El kit
Versión
0.3.1
Descarga
6,6 MB · zip
Licencia
MIT, gratis para canales monetizados
Requisitos
Unreal Engine 5.8 (gratis), una cabeza FaceNinja y un agente de programación que pueda usar MCP
Funciona en
Windows 10 u 11, macOS 14 o posterior
Una foto, y luego una cabeza que habla.
Una foto generada con IA, luego la cabeza FaceNinja creada a partir de ella, y luego esa cabeza hablando en la sala del kit, renderizada en Unreal 5.8. Primera línea: la voz gratuita Kokoro con el lip sync gratuito de Epic a partir de audio. Segunda línea: una voz de ElevenLabs con el plugin de pago Runtime MetaHuman Lip Sync. La cabeza que habla es la cabeza ARKit de FaceNinja (52 blendshapes) sobre el cuerpo y el pelo de MetaHuman Creator, renderizada offline.
Todas las personas de este video son sintéticas. Usa tu propia cara y tu propia voz, o un personaje original.
Crea una cabeza con tus fotos en FaceNinja y descarga el MetaHuman ZIP.
Tu agente monta el escenario
Descomprime el kit, abre tu agente de programación en esa carpeta y pega siete prompts, uno a uno. El agente maneja Unreal a través del propio servidor MCP de Unreal y de las herramientas del kit.
Tú haces stream
Tu iPhone o tu webcam mueven la cara. Escribe una línea y tu avatar la dice. OBS captura la ventana.
No hay código que escribir. Cada prompt termina con algo que puedes comprobar.
Descarga pequeña, todo conectado.
Una sala de streaming
Una salita cálida con sofá, estantería, una planta y luces suaves, tres cámaras (primer plano, busto, plano general) y una pantalla verde que puedes activar.
Tu MetaHuman
Una herramienta importa tu MetaHuman ZIP, conforma con exactitud la cara de MetaHuman Creator a tu cabeza y elige el pelo, las cejas y las pestañas más parecidos.
Seguimiento facial
Live Link Face en un iPhone, o el seguimiento facial con webcam de Epic.
Escribe para hablar
Un panel pequeño y un servidor de voz en tu equipo. La voz gratuita Kokoro empieza a hablar en unos 0,1 s con una tarjeta gráfica reciente.
Listo para OBS
Se ejecuta en una ventana de 1920×1080 para la captura de ventana de OBS, con pantalla verde cuando quieras tu propio fondo. NDI en Mac y Spout en Windows son opciones.
También cabezas GLB y FBX
El kit también importa el GLB o el FBX de tu cabeza con sus 52 blendshapes ARKit, a tamaño real y con el ajuste de material que Unreal necesita para mostrarlos.
Además, notas para agentes (AGENTS.md) y ajustes de MCP para Claude Code, Codex, Cursor, VS Code y Gemini CLI.
Qué necesitas.
Equipo, software y cuentas
Qué
Recomendado
Mínimo
Equipo
Windows 11 con una NVIDIA RTX 3070 o mejor, o un Mac con M2 Max o posterior y 32 GB de memoria
Un PC con tarjeta RTX y 16 GB de RAM, o un Mac con M1 o posterior y 16 GB (menos fotogramas por segundo)
Disco
150 GB libres
100 GB libres
Software
Unreal Engine 5.8, OBS, un cable de audio virtual (VB-CABLE o BlackHole) y un agente de programación. El prompt 1 los comprueba y los instala contigo.
Cuentas
FaceNinja, y una cuenta gratuita de Epic Games para el rig de MetaHuman Creator
Opcional
Un iPhone 12 o posterior con la app gratuita Live Link Face
Una webcam
Gratis por defecto.
Gratis
El kit (licencia MIT)
Unreal Engine 5.8, MetaHuman Creator y Live Link Face
El lip sync de Epic a partir de audio
OBS, BlackHole y VB-CABLE (se agradecen las donaciones)
Voces de ElevenLabs, en tu propia cuenta de ElevenLabs y facturadas por ElevenLabs por carácter
El plugin Runtime MetaHuman Lip Sync en Fab: unos 280 US$ por puesto para creadores con menos de 100.000 US$ al año, 840 US$ por encima
Unreal no cobra regalías por el video emitido o grabado. Precios de productos de otras empresas a octubre de 2026; consulta sus sitios.
Copia, pega, comprueba.
Pégalos por orden, uno a uno, y espera a que tu agente termine. Cada uno acaba con lo que deberías ver.
Los prompts se quedan en inglés en todos los idiomas, porque tu agente necesita los nombres exactos de herramientas y archivos. Puedes hablar con tu agente en tu idioma.
01 · Instala lo que necesitas
Tiempo: 20–90 minutos, sobre todo descargas
Prompt · inglés
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.
Deberías ver: cuatro marcas de verificación: Unreal 5.8, OBS, el cable y la voz.
02 · Conecta tu agente a Unreal
Tiempo: 10–20 minutos
Prompt · inglés
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.
Deberías ver: tu agente lista las herramientas de FaceNinja.
03 · Construye tu escenario
Tiempo: 2–5 minutos
Prompt · inglés
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.
Deberías ver: tres imágenes fijas de la sala.
04 · Trae tu cabeza FaceNinja
Tiempo: 15–30 minutos
Prompt · inglés
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.
Deberías ver: tu MetaHuman en la sala.
05 · Conecta tu iPhone o webcam
Tiempo: 10 minutos
Prompt · inglés
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.
Deberías ver: el avatar copia tu cara.
06 · Escribe para hablar
Tiempo: 10 minutos
Prompt · inglés
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.
Deberías ver: dice tu línea moviendo los labios.
07 · Sal en directo con OBS
Tiempo: 10 minutos
Prompt · inglés
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.
Deberías ver: tu avatar en OBS, con su voz.
Cada paso, con qué hacer si algo no funciona, está en GUIDE.md dentro del zip.
Tres tipos de voz.
Voces para escribir y hablar
Voz
Funciona en
Primer sonido
Coste
Notas
Kokoro (por defecto)
Tu equipo
Unos 0,08 s en una RTX 5080, 0,09 s en un Mac M5 Max
Gratis (Apache-2.0)
54 voces predefinidas en 8 idiomas
Tu propia voz (Chatterbox)
Tu equipo
Unos 0,7–1,1 s en una RTX 5080 o un Mac M5 Max
Gratis (MIT)
A partir de 10–20 segundos de tu propia grabación. Cada clip lleva una marca de agua inaudible que lo identifica como sintético.
Voz en la nube (ElevenLabs)
La nube
Depende de tu conexión; no lo medimos
Lo factura ElevenLabs, por carácter, según tu plan
Tus líneas escritas van a ElevenLabs. Aportas tu propia cuenta y tu propia clave de API de ElevenLabs.
Primer sonido: tiempo desde que envías una línea hasta el primer audio, medido a través del servidor de voz del kit en octubre de 2026.
Tu cara, tu voz.
Usa tu propia cara y tu propia voz, un personaje original o a una persona que lo aceptó por escrito. No hagas una imitación de una celebridad, de un streamer ni de nadie más, y no clones la voz de nadie más. Eso es suplantación de identidad: puede infringir la ley (derechos de personalidad e imagen) y infringe las normas de YouTube, Twitch y Epic.
Preguntas sobre el kit.
01¿Tengo que programar?
No. Tú pegas prompts; tu agente ejecuta las herramientas y te enseña imágenes del resultado.
02¿Funciona en Mac?
Sí, en un Mac con M1 o posterior y Unreal 5.8. Las herramientas faciales en tiempo real de Epic funcionan en Mac desde Unreal 5.8.
03¿Qué sale de mi equipo?
La forma de tu cabeza va a Epic cuando MetaHuman Creator construye el rig. Si eliges la voz en la nube, las líneas que escribes van a ElevenLabs. Nada más: ni fotos ni grabaciones.
04¿Puedo vender videos hechos con él?
Sí. El kit es MIT, Unreal no cobra regalías por video, y Kokoro y Chatterbox permiten el uso comercial. Revisa los términos de ElevenLabs y de Fab en lo que les corresponde.
05¿Incluye el plugin de lip sync de pago?
No. Se vende por puesto en Fab. El camino gratuito usa el lip sync de Epic a partir de audio.
06¿Puedo compartir mi avatar como app?
No con el lip sync gratuito: la fuente de audio de Epic funciona en el editor (Play), que es como funciona un stream de VTuber. Una app empaquetada necesita el plugin de pago.
07Solo tengo el GLB o el FBX. ¿Puedo usarlo?
Sí, para imágenes fijas y animación. Los archivos están en metros, así que la cabeza entra a tamaño real, y el kit activa Used with Morph Targets en sus materiales para que los blendshapes no se rendericen en negro. La cara y la voz en directo mueven el MetaHuman, así que usa el MetaHuman ZIP para hacer stream. Más en las notas de UnrealEN.
Licencias.
El kit es MIT (LICENSE en el zip). El arte de la sala es CC0, de Poly Haven. Todo lo demás (Unreal, MetaHuman, OBS, el cable, las voces, el plugin opcional) lo instalas tú, con su propia licencia; THIRD_PARTY.md en el zip lista cada una con su enlace.