Skip to content

One-click character swap for videos: an open-source, local Higgsfield Genjutsu alternative built on ComfyUI and MiniMax H3, with FLUX.3 Klein relighting.

Add a one-click Windows launcher

D3vozb7e13cc4866a
diff --git a/.gitattributes b/.gitattributes
index 6313b56..cc23192 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1 +1,2 @@
* text=auto eol=lf
+*.bat text eol=crlf
diff --git a/README.md b/README.md
index 73c7b74..14860e5 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,8 @@ Restart ComfyUI after installing them.
## Run it locally
+On Windows, double-click `start_openjutsu.bat` (ComfyUI must be running, or started while it waits). The first run installs `comfy-api-proxy` into `.venv-proxy` and the node packages; then it opens the proxy and the app in two windows and the page in your browser. Close those two windows to stop Openjutsu. The manual steps:
+
1. Start ComfyUI on `127.0.0.1:8188`. On Windows, set `AIOHTTP_NOSENDFILE=1` first (PowerShell: `$env:AIOHTTP_NOSENDFILE = "1"`). Without it, the first partial-file request (the video player sends one when you seek) can stall ComfyUI's `/view`, and every later file download hangs until ComfyUI restarts.
2. Install and start the proxy, which serves the Comfy API v2 on `127.0.0.1:8189`. Raise the upload cap for longer videos (the default is 100 MB):
diff --git a/start_openjutsu.bat b/start_openjutsu.bat
new file mode 100644
index 0000000..d1c5ff5
--- /dev/null
+++ b/start_openjutsu.bat
@@ -0,0 +1,43 @@
+@echo off
+setlocal
+title Openjutsu
+cd /d "%~dp0"
+
+if not exist ".venv-proxy\Scripts\comfy-api-proxy.exe" (
+ echo Installing comfy-api-proxy...
+ python -m venv .venv-proxy || goto :fail
+ ".venv-proxy\Scripts\python.exe" -m pip install comfy-api-proxy || goto :fail
+)
+if not exist "node_modules" (
+ echo Installing the app...
+ call npm ci || goto :fail
+)
+if not exist ".env.local" copy ".env.example" ".env.local" >nul
+
+curl -s -o nul -m 3 http://127.0.0.1:8188/queue
+if errorlevel 1 echo Waiting for ComfyUI on 127.0.0.1:8188. Start it now.
+:comfy
+curl -s -o nul -m 3 http://127.0.0.1:8188/queue
+if errorlevel 1 (
+ timeout /t 3 /nobreak >nul
+ goto :comfy
+)
+
+start "Openjutsu proxy" ".venv-proxy\Scripts\comfy-api-proxy.exe" run --max-upload-mb 500
+start "Openjutsu app" cmd /c npm run dev
+
+echo Starting Openjutsu...
+:app
+timeout /t 2 /nobreak >nul
+curl -s -o nul -m 30 http://127.0.0.1:3000/
+if errorlevel 1 goto :app
+start "" http://127.0.0.1:3000
+echo Openjutsu is running at http://127.0.0.1:3000
+echo To stop it, close the "Openjutsu proxy" and "Openjutsu app" windows.
+timeout /t 5 >nul
+exit /b 0
+
+:fail
+echo Setup failed, see the messages above.
+pause
+exit /b 1