Genjustsu-Open-Source-Workflow

分割加深度再生成，视频换人换物可控可预览

开源 🏷️定价信息待确认 ⏳ 访问状态待核验视频生成 🍴 复刻 292 👀 关注 14

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1204

维护状态较活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

Genjustsu-Open-Source-Workflow 项目界面预览图 — 图片来源：项目官网

项目数据

分类视频生成

开发团队sirioberati

官网地址https://tein.ai

GitHubhttps://github.com/sirioberati/Genjustsu-Open-Source-Workflow

定价模式🏷️定价信息待确认

价格说明开源工作流，定价信息待确认

访问状态⏳ 访问状态待核验

是否开源是

开源协议MIT

主要语言Python

GitHub 星标★ 1204

上线时间2026-10-06 00:00:00

代码更新2026-10-08

仓库体积12.0 MB

本站数据更新2026-10-26

维护状态较活跃

收录时间2026-10-26

浏览次数0

项目介绍

Genjustsu-Open-Source-Workflow 是 TEIN 开源的 AI 视频角色与物体替换工作流，用 Python 实现。它把视频替换拆成可审查的多个环节：先用深度图估计空间结构，用 SAM 做分割得到掩码，再结合人脸网格与音频处理准备输入，最后调用 Seedance 生成替换内容。项目自带本地 Web UI，可上传素材、逐帧检查掩码、预览生成结果，并导出保留原始音轨的视频。相比直接端到端生成，它强调中间结果可见可改，降低替换错位和音画不同步的风险，适合需要精细控制人物或物体替换的创作者与研究者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-10-26 · 当前星标 ★ 1204

使用教程

难度：进阶约 30 分钟部署方式：本地安装 8 步

环境要求

Python 3.12+（开发环境使用 3.14）
Rubber Band CLI 命令行工具
cloudflared；如果已有公网 HTTPS webhook 接收端，可以不安装
自己的 Enhancor API Key 和 Replicate API Token，并确保对应账号已开通相关服务
macOS 或 Linux；原生 Windows 需使用 WSL2

安装与启动步骤

1安装系统依赖

安装 Rubber Band 命令行；Linux 或 WSL 改用 apt 命令，并按 README 安装 cloudflared。
```
brew install rubberband cloudflared
```
2Linux 安装依赖

Ubuntu、Debian 或 WSL 用这条命令；之后需自行安装 cloudflared，除非已有 webhook。
```
sudo apt install rubberband-cli python3-venv
```
3运行安装脚本

在项目目录执行，会创建隔离的 .venv、安装 requirements.txt 并生成空白 .env。
```
bash setup.sh
```
4启用人脸网格模式

安装 Python 3.12 后运行脚本，再用 doctor 检查三种模式是否可用。
```
brew install python@3.12
bash setup-face-mesh.sh
.venv/bin/python doctor.py --mesh
```
5填写密钥

在 .env 中填入自己的 ENHANCOR_API_KEY 与 REPLICATE_API_TOKEN，不要覆盖已有内容。
6启动应用

启动本地 UI 和回调隧道；端口被占用时用 PORT=8771 bash start.command。
```
./start.command
```
7打开界面并自检

浏览器访问 http://127.0.0.1:8770，另开终端运行严格就绪检查。
```
.venv/bin/python doctor.py --require-keys
```
8执行替换流程

上传 MP4/MOV、检查整段掩码与预处理视频、批准掩码、提供角色参考并先生成草稿，满意后再点 1080p 批准。

关键配置

配置项	必填	说明	示例
`ENHANCOR_API_KEY`	是	调用 Enhancor 上 Seedance 生成服务的密钥	`your-enhancor-api-key`
`REPLICATE_API_TOKEN`	是	Replicate 平台访问令牌	`r8_xxxxxxxxxxxxxxxx`
`HF_TOKEN`	否	仅在改用 Hugging Face 深度方案时需要	`hf_xxxxxxxxxxxxxxxx`
`ENHANCOR_WEBHOOK_URL`	否	自定义回调地址；不填则启动时自动建立临时隧道	`https://your-domain.com/webhook`
`PORT`	否	覆盖默认 UI 端口 8770	`8771`