FaceNinja

Kit de creador · para VTubers · gratis

Tu cara. Tu stream.

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ón0.3.1
Descarga6,6 MB · zip
LicenciaMIT, gratis para canales monetizados
RequisitosUnreal Engine 5.8 (gratis), una cabeza FaceNinja y un agente de programación que pueda usar MCP
Funciona enWindows 10 u 11, macOS 14 o posterior

Una foto, y luego una cabeza que habla.

Video de demostración del kit de creador
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.

Descargar el video (MP4, 7,3 MB)

Tres partes, una tarde.

  1. Tu cabeza

    Crea una cabeza con tus fotos en FaceNinja y descarga el MetaHuman ZIP.

  2. 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.

  3. 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éRecomendadoMínimo
EquipoWindows 11 con una NVIDIA RTX 3070 o mejor, o un Mac con M2 Max o posterior y 32 GB de memoriaUn PC con tarjeta RTX y 16 GB de RAM, o un Mac con M1 o posterior y 16 GB (menos fotogramas por segundo)
Disco150 GB libres100 GB libres
SoftwareUnreal 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.
CuentasFaceNinja, y una cuenta gratuita de Epic Games para el rig de MetaHuman Creator
OpcionalUn iPhone 12 o posterior con la app gratuita Live Link FaceUna 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)
  • Las voces Kokoro y Chatterbox, en tu equipo

De pago, solo si lo eliges

  • Tu cabeza FaceNinja, en créditos (precios)
  • 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
VozFunciona enPrimer sonidoCosteNotas
Kokoro (por defecto)Tu equipoUnos 0,08 s en una RTX 5080, 0,09 s en un Mac M5 MaxGratis (Apache-2.0)54 voces predefinidas en 8 idiomas
Tu propia voz (Chatterbox)Tu equipoUnos 0,7–1,1 s en una RTX 5080 o un Mac M5 MaxGratis (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 nubeDepende de tu conexión; no lo medimosLo factura ElevenLabs, por carácter, según tu planTus 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.

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 Unreal EN.

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.

¿Listo? Crea tu cabeza y luego descarga el kit.