Κάντε το κεφάλι σας από το 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 ή νεότερο
Μία φωτογραφία, μετά ένα κεφάλι που μιλά.
Μία φωτογραφία που δημιουργήθηκε με 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.
Όλοι όσοι εμφανίζονται σε αυτό το βίντεο είναι συνθετικά πρόσωπα. Χρησιμοποιήστε το δικό σας πρόσωπο και τη δική σας φωνή ή έναν πρωτότυπο χαρακτήρα.
Φτιάξτε ένα κεφάλι από τις φωτογραφίες σας στο FaceNinja και κατεβάστε το MetaHuman ZIP.
Ο agent σας χτίζει τη σκηνή
Αποσυμπιέστε το kit, ανοίξτε τον coding agent σας σε αυτόν τον φάκελο και επικολλήστε επτά prompts, ένα ένα. Ο agent χειρίζεται το Unreal μέσω του MCP server του ίδιου του Unreal και των εργαλείων του kit.
Κάνετε 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.
Το πρόσωπό σας, η φωνή σας.
Χρησιμοποιήστε το δικό σας πρόσωπο και τη δική σας φωνή, έναν πρωτότυπο χαρακτήρα ή ένα άτομο που συμφώνησε γραπτώς. Μη δημιουργείτε σωσία διασημότητας, streamer ή οποιουδήποτε άλλου και μην κλωνοποιείτε τη φωνή κανενός άλλου. Αυτό είναι πλαστοπροσωπία: μπορεί να παραβιάζει τον νόμο (δικαιώματα προσωπικότητας και δημοσιότητας) και παραβιάζει τους κανόνες του YouTube, του Twitch και της Epic.
Ερωτήσεις για το 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. Περισσότερα στις σημειώσεις UnrealEN.
Άδειες.
Το kit έχει άδεια MIT (LICENSE στο zip). Τα γραφικά του δωματίου είναι CC0 από το Poly Haven. Όλα τα υπόλοιπα (Unreal, MetaHuman, OBS, το καλώδιο, οι φωνές, το προαιρετικό plugin) τα εγκαθιστάτε εσείς, με τη δική τους άδεια το καθένα· το THIRD_PARTY.md στο zip τα παραθέτει ένα ένα με τον σύνδεσμό τους.
Έτοιμοι; Φτιάξτε το κεφάλι σας και μετά κατεβάστε το kit.