sirioberati / Emotion-Control-Open-Source-Workflow

Emotion Control 
 A performance starts with a face. Keep the expression. Change the appearance. 
 Sirio's final glossy clay mask workflow — tracked motion, fitted geometry, source detail, and 478 green points. 
 Join the TEIN AI waitlist → · Setup · Set up with an agent · Mask gallery · License 
 Want more open-source AI filmmaking workflows? Join the TEIN AI waitlist for updates on new workflows, tools, and releases. Join the waitlist at tein.ai → Join our free community → 
## See the performance transfer
Two supplied examples. Click a GIF to open the full MP4 with sound.
### Courtroom performance
Watch full example ↗
### Emotional performance
Watch full example ↗
The generated appearances are demonstration results from a separate generation step. This repository builds the performance masks; it does not bundle a video-generation model or make paid API calls.
## The masks
Two actual extracted masks: the smiling-man performance and the emotional-reaction performance. GIFs are silent excerpts; full MP4s retain source audio. The full mask clips and edited example videos can have different durations.
### Expressive performance — original → mask → Sirio
The matching original is the source recorded in this mask's run manifest. The generated result is the supplied Seedance video. These previews show the crying section near the end of the performance.
**Original performance**
Watch original video ↗
**Tracked mask**
Download mask MP4 ↗
**Sirio — generated result**
Watch Sirio's video ↗
### Emotional mask — transition into crying
Download mask MP4 ↗
## One pipeline
 [code] 
- **Expression timing:** per-frame lips and eyelids, with temporal context isolated at cuts.
- **Readable detail:** grayscale source eyes and mouth, UV-derived crease shading and gloss.
- **The final material:** 84% clay on skin, 10% in protected features, directional light and clear coat.
- **Useful exports:** isolated mask, source/mask comparison, detail/material comparison, validation report.
This is the approved `approved-sculpted-glossy-v1` implementation. The public package only changes executable discovery and setup; the fitting and material math are preserved. See provenance and validation.
Full implementation map: tech stack, every processing stage, and every material layer.
## Get started
Python 3.12, FFmpeg, and separately obtained model assets are required. Follow the complete setup guide first. FLAME and SPECTRE have research/noncommercial restrictions; the wrapper's MIT license does not override them.
 [code] 
Use a raw performance video as input, not the supplied comparison montages. Review the pilot, then process the full clip into a new folder:
 [code] 
For unchanged interrupted runs, repeat the command with `--resume`. Changed source, trim, settings or code require a **new output folder**.
### Set up with your coding agent
Give your agent this prompt from the cloned repository:
> Read docs/SETUP-AGENT.md and docs/SETUP.md. Set up this exact approved mask pipeline. Inc