D3voz/openjutsu

选用指南

AI 根据 README 整理 · 2026/10/30 03:46:42

使用方式

通过浏览器界面使用，需先启动 ComfyUI 和代理，然后运行 npm start 启动应用，访问 http://127.0.0.1:3000。

查看 README 依据

On Windows, double-click `start_openjutsu.bat` (ComfyUI must be running, or started while it waits). The first run installs `comfy-api-proxy` 0.1.6 into `.venv-proxy` and the node packages, and `patch_proxy.py` fixes the proxy's live progress (node changes and mid-job previews). Each run builds the app, then opens the proxy and the app (`npm start`, the production server) in two windows and the page in your browser. Close those two windows to stop Openjutsu. The manual steps:

python openjutsu/patch_proxy.py comfy-api-proxy run --max-upload-mb 500 ``` 3. Install and start the app: ```sh git clone <this repo> openjutsu cd openjutsu cp .env.example .env.local npm ci npm run build npm start ``` While changing the code, `npm run dev` runs the development server instead. 4. Open <http://127.0.0.1:3000>.

部署要求

需要 NVIDIA GPU（测试于 RTX 4060 Ti 16GB），ComfyUI 0.41.2 或更高版本，Node.js 22.6 或更高版本，以及 Python 用于 comfy-api-proxy。

查看 README 依据

- An NVIDIA GPU. Tested on an RTX 4060 Ti 16 GB with 64 GB of system RAM; the H3 int8 models stream from RAM. - [ComfyUI](https://github.com/comfyanonymous/ComfyUI) 0.41.2 or newer. Core provides MiniMax H3, SAM 3.1 and TextGenerate. - Node.js 22.6 or newer, and Python for `comfy-api-proxy`. ### Custom nodes Install these into `ComfyUI/custom_nodes` (ComfyUI Manager finds the first three by name): | Pack | Used for | | --- | --- | | [SolarRenderer](https://github.com/Enderfga/SolarRenderer/tree/main/comfyui) | From picture: SolarRenderer LoRA loading, conditioning and four-step sampling |

已知限制

镜像和反射效果尚不支持，H3 在人物较小时面部绘制效果不佳，需使用修复功能。

查看 README 依据

- **Mirrors and reflections do not work yet**, in either mode. The reflection keeps the original person, and H3 copies their look from it: hair, outfit and build come back on your character. Use videos without a mirror, window or other reflection of the person. - **Who do they replace?** names the person for the prompt by role (`the singer`), never by clothes: clothing words leak into the result. Leave it blank and the describer names them.

- **Post-processing**: available, for a finished video. **Fix faces**: H3 draws faces poorly when the person is small in the frame, so this redraws the face of the person in a photo at close-up size and pastes it back. Runs `workflows/face.api.json`, written by `workflows/build/openjutsu_face_build.py`. **Fix colours** softens H3's harsh look without an H3 run: Image Detail Contrast takes some fine detail contrast out, then Orion4D's DCTL Tone Mapper grades every frame. Runs `workflows/color.api.json`. ## Requirements