sirioberati / Genjustsu-Open-Source-Workflow

Join TEIN AI → 
 Click any preview to open its full video with audio. 
 Genjustsu — Open Source Workflow 
 Your scene. New characters. 
 Join TEIN AI ·
 Get the Seedance API ·
 Agent setup ·
 Examples ·
 MIT license 
A local UI and agent-assisted workflow for replacing video subjects using colored depth, SAM 3 masks and Seedance through Enhancor. Draft first; approve before 1080p. The final export restores the **entire original source audio**, not generated audio.
## Get access
- **Sign up at TEIN.ai** for early access: “The cheapest APIs, open source workflows, and more.”
- **Get the Seedance API at Enhancor.ai** — this workflow uses its Seedance integration with human-face support (`pass_faces: true`), draft previews, and approved 1080p generation. Get your own key from the API dashboard. Current the lowest price in the market; with unrestricted use.
## Easiest setup: let your coding agent install it
Extract the ZIP, open **this folder** in Codex or another coding agent with terminal/file access, and paste:
> Set up this TEIN Genjustsu — Open Source Workflow project for me. Read `docs/SETUP-AGENT.md` and follow it end to end. Detect my OS, install missing Python/Rubber Band/cloudflared prerequisites using the supported package manager, create the main virtual environment, install dependencies, install Python 3.12 and run `bash setup-face-mesh.sh` for both mesh modes, and create `.env` without overwriting it. Open `.env` so I can enter my own keys privately. Run the local tests, launch the app and its callback-only tunnel, run the strict readiness check on a free localhost port, verify the UI and companion images, and give me the working URL. Work independently through setup, respecting system permission prompts. Do not submit paid generations. If keys are missing, launch the UI and clearly tell me generation is waiting for them.
The launcher starts a callback-only Quick Tunnel when no custom webhook is configured. Keep it running with the app. The agent uses the included setup runbook. You only need to supply your own provider keys and approve any required system installation. No separate agent install is required. Native Windows users should use WSL2; macOS/Linux launch scripts are included.
## Manual setup
1. Install Python 3.12+ (the development runtime was Python 3.14) and Rubber Band CLI:
 - macOS: `brew install rubberband cloudflared`
 - Ubuntu/Debian or WSL: `sudo apt install rubberband-cli python3-venv`
 - Install cloudflared too, unless you already have a public HTTPS webhook receiver. On launch it creates a temporary callback-only tunnel; the UI and media stay on localhost.
2. In this folder, run `bash setup.sh`. This creates an isolated `.venv`, installs `requirements.txt`, creates a blank `.env`, and checks dependencies. To enable all three modes, install Python 3.12 and run `bash setup-face-mesh.sh`, then `.venv/bin/python doctor.py --mesh`. On macOS, install the worker interpreter with `brew install python@3.12` if needed.
3. Fill