FaceNinja

Creator Kit · για VTubers · δωρεάν

Το πρόσωπό σας. Το stream σας.

Κάντε το κεφάλι σας από το FaceNinja ένα MetaHuman που μιλά και κινείται μαζί σας, σε μια μικρή σκηνή στο Unreal Engine 5.8. Ο coding agent σας το χτίζει από επτά prompts. Εσείς πληκτρολογείτε, αυτό μιλά· εσείς χαμογελάτε, αυτό χαμογελά. Μετά το καταγράφετε στο OBS.

Έκδοση 0.3.1 · 6,6 MB · άδεια MIT · Windows και Mac

Μέγεθος και SHA-256 για scripts και agents: version.json

Το kit
Έκδοση0.3.1
Λήψη6,6 MB · zip
ΆδειαMIT, δωρεάν και για κανάλια που βγάζουν έσοδα
ΑπαιτείUnreal Engine 5.8 (δωρεάν), ένα κεφάλι FaceNinja και ένας coding agent που μπορεί να χρησιμοποιεί MCP
Τρέχει σεWindows 10 ή 11, macOS 14 ή νεότερο

Μία φωτογραφία, μετά ένα κεφάλι που μιλά.

Βίντεο demo του Creator Kit
Μία φωτογραφία που δημιουργήθηκε με AI, μετά το κεφάλι FaceNinja που φτιάχτηκε από αυτήν, μετά αυτό το κεφάλι να μιλά στο δωμάτιο του kit, με render στο Unreal 5.8. Πρώτη ατάκα: η δωρεάν φωνή Kokoro με το δωρεάν lip sync από ήχο της Epic. Δεύτερη ατάκα: μια φωνή ElevenLabs με το επί πληρωμή plugin Runtime MetaHuman Lip Sync. Το κεφάλι που μιλά είναι το κεφάλι ARKit του FaceNinja (52 blendshapes) πάνω στο σώμα και στα μαλλιά του MetaHuman Creator, με offline render.

Όλοι όσοι εμφανίζονται σε αυτό το βίντεο είναι συνθετικά πρόσωπα. Χρησιμοποιήστε το δικό σας πρόσωπο και τη δική σας φωνή ή έναν πρωτότυπο χαρακτήρα.

Λήψη του βίντεο (MP4, 7,3 MB)

Τρία μέρη, ένα βράδυ.

  1. Το κεφάλι σας

    Φτιάξτε ένα κεφάλι από τις φωτογραφίες σας στο FaceNinja και κατεβάστε το MetaHuman ZIP.

  2. Ο agent σας χτίζει τη σκηνή

    Αποσυμπιέστε το kit, ανοίξτε τον coding agent σας σε αυτόν τον φάκελο και επικολλήστε επτά prompts, ένα ένα. Ο agent χειρίζεται το Unreal μέσω του MCP server του ίδιου του Unreal και των εργαλείων του kit.

  3. Κάνετε stream

    Το iPhone ή η webcam σας κινεί το πρόσωπο. Πληκτρολογήστε μια φράση και το avatar σας την λέει. Το OBS καταγράφει το παράθυρο.

Δεν γράφετε κώδικα. Κάθε prompt τελειώνει με κάτι που μπορείτε να ελέγξετε.

Μικρή λήψη, όλα συνδεδεμένα.

Δωμάτιο για stream

Ένα ζεστό δωματιάκι με καναπέ, βιβλιοθήκη, φυτό και απαλά φώτα, τρεις κάμερες (κοντινό, προτομή, γενικό πλάνο) και ένα green screen που μπορείτε να ενεργοποιήσετε.

Το MetaHuman σας

Ένα εργαλείο εισάγει το MetaHuman ZIP σας, προσαρμόζει σε αυτό με ακρίβεια το πρόσωπο του MetaHuman Creator και διαλέγει τα πιο κοντινά μαλλιά, φρύδια και βλεφαρίδες.

Παρακολούθηση προσώπου

Live Link Face σε iPhone ή το face tracking από webcam της Epic.

Γράψτε για να μιλήσει

Ένα μικρό πάνελ και ένας voice server στον υπολογιστή σας. Η δωρεάν φωνή Kokoro αρχίζει να μιλά σε περίπου 0,1 s σε πρόσφατη κάρτα γραφικών.

Έτοιμο για OBS

Αναπαραγωγή σε παράθυρο 1920×1080 για window capture από το OBS, με green screen όταν θέλετε δικό σας φόντο. Το NDI σε Mac και το Spout σε Windows είναι επιλογές.

Και κεφάλια GLB και FBX

Το kit εισάγει επίσης το GLB ή το FBX του κεφαλιού σας με τα 52 ARKit blendshapes, σε φυσικό μέγεθος και με τη ρύθμιση υλικού που χρειάζεται το Unreal για να τα εμφανίσει.

Συν σημειώσεις για agents (AGENTS.md) και ρυθμίσεις MCP για Claude Code, Codex, Cursor, VS Code και Gemini CLI.

Τι χρειάζεστε.

Υπολογιστής, λογισμικό και λογαριασμοί
ΤιΠροτεινόμενοΕλάχιστο
ΥπολογιστήςWindows 11 με NVIDIA RTX 3070 ή καλύτερη κάρτα, ή Mac με M2 Max ή νεότερο και 32 GB μνήμηςPC με κάρτα RTX και 16 GB RAM, ή Mac με M1 ή νεότερο και 16 GB (χαμηλότερο frame rate)
Δίσκος150 GB ελεύθερα100 GB ελεύθερα
ΛογισμικόUnreal Engine 5.8, OBS, ένα εικονικό καλώδιο ήχου (VB-CABLE ή BlackHole) και ένας coding agent. Το prompt 1 τα ελέγχει και τα εγκαθιστά μαζί σας.
ΛογαριασμοίFaceNinja και ένας δωρεάν λογαριασμός Epic Games για το rig του MetaHuman Creator
ΠροαιρετικάiPhone 12 ή νεότερο με τη δωρεάν εφαρμογή Live Link FaceΜια webcam

Δωρεάν από προεπιλογή.

Δωρεάν

  • Το kit (άδεια MIT)
  • Unreal Engine 5.8, MetaHuman Creator και Live Link Face
  • Το lip sync από ήχο της Epic
  • OBS, BlackHole και VB-CABLE (δωρεές ευπρόσδεκτες)
  • Οι φωνές Kokoro και Chatterbox, στον υπολογιστή σας

Επί πληρωμή, μόνο αν το θέλετε

  • Το κεφάλι σας από το FaceNinja, σε credits (τιμές)
  • Φωνές ElevenLabs, στον δικό σας λογαριασμό ElevenLabs, με χρέωση από την ElevenLabs ανά χαρακτήρα
  • Το plugin Runtime MetaHuman Lip Sync στο Fab: περίπου 280 $ ανά θέση για δημιουργούς κάτω από 100.000 $ τον χρόνο, 840 $ πάνω από αυτό

Το Unreal δεν χρεώνει δικαιώματα εκμετάλλευσης (royalty) για βίντεο που μεταδίδεται ή καταγράφεται. Τιμές προϊόντων άλλων εταιρειών, όπως ήταν τον Οκτώβριο του 2026· ελέγξτε τους ιστότοπούς τους.

Αντιγραφή, επικόλληση, έλεγχος.

Επικολλήστε τα με τη σειρά, ένα ένα, και περιμένετε μέχρι να τελειώσει ο agent σας. Κάθε ένα τελειώνει με αυτό που πρέπει να δείτε.

Τα prompts μένουν στα αγγλικά σε κάθε γλωσσική έκδοση, επειδή ο agent σας χρειάζεται ακριβώς τα ονόματα των εργαλείων και των αρχείων. Μπορείτε να μιλάτε στον agent σας στη γλώσσα σας.

01 · Εγκαταστήστε ό,τι χρειάζεστε

Διάρκεια: 20–90 λεπτά, κυρίως λήψεις

Prompt · Αγγλικά
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.

Θα πρέπει να δείτε: τέσσερα τικ: Unreal 5.8, OBS, το καλώδιο και η φωνή.

02 · Συνδέστε τον agent στο Unreal

Διάρκεια: 10–20 λεπτά

Prompt · Αγγλικά
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.

Θα πρέπει να δείτε: ο agent σας απαριθμεί τα εργαλεία του FaceNinja.

03 · Χτίστε τη σκηνή σας

Διάρκεια: 2–5 λεπτά

Prompt · Αγγλικά
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.

Θα πρέπει να δείτε: τρεις στατικές εικόνες του δωματίου.

04 · Εισάγετε το κεφάλι FaceNinja

Διάρκεια: 15–30 λεπτά

Prompt · Αγγλικά
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.

Θα πρέπει να δείτε: το MetaHuman σας στο δωμάτιο.

05 · Συνδέστε iPhone ή webcam

Διάρκεια: 10 λεπτά

Prompt · Αγγλικά
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.

Θα πρέπει να δείτε: το avatar αντιγράφει το πρόσωπό σας.

06 · Γράψτε για να μιλήσει

Διάρκεια: 10 λεπτά

Prompt · Αγγλικά
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.

Θα πρέπει να δείτε: λέει τη φράση σας με κινούμενα χείλη.

07 · Ξεκινήστε live με το OBS

Διάρκεια: 10 λεπτά

Prompt · Αγγλικά
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.

Θα πρέπει να δείτε: το avatar σας στο OBS, με τη φωνή του.

Κάθε βήμα, μαζί με το τι να κάνετε όταν κάτι δεν δουλεύει, υπάρχει στο GUIDE.md μέσα στο zip.

Τρία είδη φωνής.

Φωνές για μετατροπή κειμένου σε ομιλία
ΦωνήΤρέχει σεΠρώτος ήχοςΚόστοςΣημειώσεις
Kokoro (προεπιλογή)Ο υπολογιστής σαςΠερίπου 0,08 s σε RTX 5080, 0,09 s σε Mac με M5 MaxΔωρεάν (Apache-2.0)54 έτοιμες φωνές σε 8 γλώσσες
Η δική σας φωνή (Chatterbox)Ο υπολογιστής σαςΠερίπου 0,7–1,1 s σε RTX 5080 ή Mac με M5 MaxΔωρεάν (MIT)Από 10–20 δευτερόλεπτα δικής σας ηχογράφησης. Κάθε κλιπ φέρει ένα μη ακουστό υδατογράφημα που το επισημαίνει ως συνθετικό.
Φωνή στο cloud (ElevenLabs)Το cloudΕξαρτάται από τη σύνδεσή σας· δεν το έχουμε μετρήσειΧρέωση από την ElevenLabs, ανά χαρακτήρα, σύμφωνα με το πλάνο σαςΟι φράσεις που πληκτρολογείτε πηγαίνουν στην ElevenLabs. Φέρνετε τον δικό σας λογαριασμό ElevenLabs και κλειδί API.

Πρώτος ήχος: ο χρόνος από την αποστολή μιας φράσης μέχρι τον πρώτο ήχο, μετρημένος μέσω του voice server του kit τον Οκτώβριο του 2026.

Ερωτήσεις για το kit.

01Χρειάζεται να προγραμματίσω;
Όχι. Επικολλάτε prompts· ο agent σας τρέχει τα εργαλεία και σας δείχνει εικόνες του αποτελέσματος.
02Δουλεύει σε Mac;
Ναι, σε Mac με M1 ή νεότερο και Unreal 5.8. Τα εργαλεία προσώπου πραγματικού χρόνου της Epic τρέχουν σε Mac από το Unreal 5.8.
03Τι φεύγει από τον υπολογιστή μου;
Το σχήμα του κεφαλιού σας πηγαίνει στην Epic όταν το MetaHuman Creator χτίζει το rig. Αν διαλέξετε τη φωνή στο cloud, οι φράσεις που πληκτρολογείτε πηγαίνουν στην ElevenLabs. Τίποτα άλλο: ούτε φωτογραφίες ούτε ηχογραφήσεις.
04Μπορώ να πουλήσω βίντεο που φτιάχτηκαν με αυτό;
Ναι. Το kit έχει άδεια MIT, το Unreal δεν χρεώνει δικαιώματα για βίντεο και τα Kokoro και Chatterbox επιτρέπουν εμπορική χρήση. Ελέγξτε τους όρους της ElevenLabs και του Fab για τα δικά τους μέρη.
05Περιλαμβάνεται το επί πληρωμή plugin για lip sync;
Όχι. Πωλείται ανά θέση στο Fab. Η δωρεάν επιλογή χρησιμοποιεί το lip sync από ήχο της ίδιας της Epic.
06Μπορώ να μοιραστώ το avatar μου ως εφαρμογή;
Όχι με το δωρεάν lip sync: η πηγή ήχου της Epic δουλεύει στο editor (Play), και έτσι τρέχει ένα stream VTuber. Μια εφαρμογή σε package χρειάζεται το επί πληρωμή plugin.
07Έχω μόνο το GLB ή το FBX. Μπορώ να το χρησιμοποιήσω;
Ναι, για στατικές εικόνες και animation. Τα αρχεία είναι σε μέτρα, οπότε το κεφάλι έρχεται σε φυσικό μέγεθος, και το kit ενεργοποιεί το Used with Morph Targets στα υλικά του ώστε τα blendshapes να μην εμφανίζονται μαύρα. Το ζωντανό πρόσωπο και η φωνή κινούν το MetaHuman, οπότε για streaming χρησιμοποιήστε το MetaHuman ZIP. Περισσότερα στις σημειώσεις Unreal EN.

Άδειες.

Το kit έχει άδεια MIT (LICENSE στο zip). Τα γραφικά του δωματίου είναι CC0 από το Poly Haven. Όλα τα υπόλοιπα (Unreal, MetaHuman, OBS, το καλώδιο, οι φωνές, το προαιρετικό plugin) τα εγκαθιστάτε εσείς, με τη δική τους άδεια το καθένα· το THIRD_PARTY.md στο zip τα παραθέτει ένα ένα με τον σύνδεσμό τους.

Έτοιμοι; Φτιάξτε το κεφάλι σας και μετά κατεβάστε το kit.