Reading the repo
Reading the repo
How to install on Windows
A clonable Comfy character-swap app and development guide
Saved setup from 5 h ago
Will it work on Windows?
Heads-upIt also needs 2 settings in .env (1 secret).
Then run powershell -ExecutionPolicy Bypass -File .\setup.ps1. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: winget install Git.Git
git clone https://github.com/Comfy-Org/comfy-openjutsu.git cd comfy-openjutsu
Node.js >=22.6.0
winget install CoreyButler.NVMforWindows nvm install lts nvm use lts
Fill in secrets: COMFY_API_KEY
Copy-Item .env.example .env.local
npm ci
npm run dev
npm test
Install Node.js 22.6 or newer. Prepare a Comfy Developer Platform deployment with the patched h3_character_swap node pack, MiniMax H3, SAM 3.1 and the two LoRAs by following build/model-files.md. Cloning this repo does not create that deployment.
Copy this repository and make local settings:
git clone https://github.com/Comfy-Org/comfy-openjutsu.git
cd comfy-openjutsu
cp .env.example .env.local
Add the API key for the workspace that owns your deployment to COMFY_API_KEY. Set COMFY_BASE_URL to the deployment URL from the Developer Platform; the SDK reads both variables from .env.local on the server.
Install and start the app:
npm ci
npm run dev
Open http://localhost:3000. Pick one of the examples, or choose a clip of one continuous shot with a person in its first frame, and a character image. Pick where the part starts and how long it is, then select Swap character.
The first job may take several minutes while the deployment starts and loads its models; a 5 second part at 480p took about two minutes on a warm worker. The server reads the key from .env.local; do not expose it in a NEXT_PUBLIC_ variable or commit the file.
No reports for Windows yet.
Opens a chat with this manual already filled in, for Windows. It uses your own account; gitmanual sends nothing.