openjutsu

一键换掉视频里的角色，本地跑还带重打光

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署视频生成 🍴 复刻 269 🐛 待处理 48 👀 关注 17

GitHub ↗

GitHub 星标 ★ 1897

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源免费，需本地部署

项目预览

项目数据

分类视频生成

开发团队D3voz

GitHubhttps://github.com/D3voz/openjutsu

定价模式🏷️完全免费

价格说明开源免费，需本地部署

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型character-swap,comfyui,minimax-h3,nextjs,open-weights,opensourcehiggsfield,video-generation

GitHub 星标★ 1897

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

代码更新2026-10-30

仓库体积68.3 MB

本站数据更新2026-11-08

维护状态较活跃

收录时间2026-11-07

浏览次数0

项目介绍

openjutsu 是一个开源的视频角色替换工具，目标是提供一键式的视频人物换脸/换角能力，作为 Higgsfield Genjutsu 的本地替代方案。项目基于 ComfyUI 搭建生成流程，结合 MiniMax H3 模型与 FLUX.3 Klein 重打光能力，让用户可以在本地完成视频中角色的替换，并保持光照一致性。前端使用 Next.js 与 TypeScript 实现，提供较友好的操作界面，降低 ComfyUI 工作流的使用门槛。核心能力包括：一键式角色替换、视频级处理、重打光以匹配原视频环境、本地运行以保护隐私。适合内容创作者、短视频制作者、AI 视频研究者进行角色替换实验与创作。项目处于成长阶段，星标约 1.8k，社区仍在积累中。

Star 增长趋势

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

数据来源：GitHub API 逐日快照 · 收录于 2026-11-07 · 当前星标 ★ 1897

技术标签

comfyui minimax-h3 nextjs video-generation

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

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

环境要求

已安装可运行的 ComfyUI，并确保其监听在 127.0.0.1:8188
ComfyUI 中已准备好 H3 视频模型与相关自定义节点（comfyui-h3-oneclick-swap 等）及所需模型文件
Node.js 与 npm（用于 npm ci、npm run build、npm start）
Python 与 pip（用于安装 comfy-api-proxy 0.1.6 并运行 patch_proxy.py）
已验证配置为 16GB 显存显卡 + 64GB 系统内存

安装与启动步骤

1启动 ComfyUI

先让 ComfyUI 在 127.0.0.1:8188 跑起来。Windows 必须先设置该环境变量，否则拖动视频进度后 /view 请求会卡住，后续文件下载全部挂起。
```
$env:AIOHTTP_NOSENDFILE = "1"
```
2克隆仓库

把项目下载到本地并进入目录，后续 patch_proxy.py 的相对路径依赖仓库目录名 openjutsu。
```
git clone https://github.com/D3voz/openjutsu.git openjutsu
cd openjutsu
```
3安装代理并打补丁

安装 0.1.6 版 comfy-api-proxy，再用仓库自带 patch_proxy.py 修复实时进度（节点变化与中途预览）。两条命令需用同一个 Python 执行。
```
pip install comfy-api-proxy==0.1.6
python openjutsu/patch_proxy.py
```
4启动代理服务

代理会在 127.0.0.1:8189 提供 Comfy API v2。默认上传上限 100MB，长视频用 --max-upload-mb 提高（应用整体单次请求上限 512MB）。
```
comfy-api-proxy run --max-upload-mb 500
```
5生成环境配置

从示例复制配置文件，然后在 .env.local 中把 COMFY_BASE_URL 指向代理地址；本地代理场景下 COMFY_API_KEY 留空。
```
cp .env.example .env.local
```
6安装依赖并构建

用 npm ci 按锁文件安装依赖，再构建生产版本。开发调试时可用 npm run dev 代替 build + start。
```
npm ci
npm run build
npm start
```
7打开页面使用

浏览器访问应用地址，上传视频和角色照片后点 Generate 即可开始生成，整个处理过程在本地 GPU 上完成。

关键配置

配置项	必填	说明	示例
`COMFY_BASE_URL`	是	应用访问的 Comfy 接口地址，本地指向代理服务	`http://127.0.0.1:8189`
`COMFY_API_KEY`	否	云端部署时的接口密钥，本地代理留空
`COMFYUI_URL`	否	用于读取模型与 LoRA 列表，不配置则相关选择框变成文本框	`http://127.0.0.1:8188`
`OPENJUTSU_PASSWORD`	否	对外提供访问时必填，至少 12 位，配合 HTTPS 使用	`Openjutsu-2024-strong`
`PORT`	否	Next.js 监听端口，宿主未指定时默认 3000	`3000`
`AIOHTTP_NOSENDFILE`	否	Windows 上必须设为 1，避免 /view 请求阻塞导致下载挂起	`1`