面向普通用户的 ControlNet 预处理桌面工具。Windows 10/11 x64，独立于 ComfyUI。
项目主页与源码：github.com/sharbvane/openpre。
安装 OpenPre-1.1.0-Windows-x64-Setup.exe，或完整解压 ZIP 后打开 OpenPre.exe。
不需要安装 Python、ComfyUI、CUDA Toolkit。GPU 模式支持 NVIDIA CUDA；其他显卡使用 CPU。
首次启动先到“设置与帮助”安装 CPU 运行环境；GPU 环境可跳过或稍后安装。添加图片或视频 → 在下拉列表勾选一个或多个效果 → 调整当前效果参数 → 开始处理。 支持 Canny、DWPose、Depth Anything V2 Small、HED、Lineart、AnyLine、Normal BAE、SegFormer B0 分割。 第一次使用某模型时联网下载，后续离线处理。默认从 Hugging Face 下载，可在设置中切换 hf-mirror.com 或自定义兼容的 HTTPS 镜像。
图片输出 PNG，保持原尺寸并按 EXIF 方向处理；透明区域合成到白色背景。 视频输出 H.264 MP4，默认保持显示分辨率、原平均帧率，可自定义尺寸和帧率。 可变帧率视频转换为平均帧率的恒定帧率视频。保留原音频时将第一条音轨转为 AAC；也可无声导出。 奇数宽高使用 yuv444p 保留准确尺寸，部分硬件播放器可能不支持，可选择偶数尺寸。 逐帧模型不保证视频时序一致性。
- 设置、模型、缓存、运行环境、日志和默认输出均位于安装目录的
data文件夹，安装到其他磁盘即可避免占用 C 盘。 - 模型、缓存、运行环境、日志和输出目录均可在设置页单独修改。
- 更改目录不迁移已有文件；可以手动移动后指向新目录。
- 模型管理可查看大小、用途、保存位置、下载进度，删除或重新下载。
- 取消时保留已完成结果，不留下未完成的导出文件。当前推理结束后响应取消；网络连接最多可能等待一次超时。
- 输入文件不会上传到远程服务器。仅模型下载访问配置的下载源。
- 不覆盖原文件，输出带任务标识；每次任务生成结果清单 JSON。
GPU 不可用或显存不足时，请切换 CPU 或降低处理精度。CPU 下处理复杂视频可能较慢。 轻量发布包不携带推理运行环境。CPU 环境下载约 752 MiB；可选 GPU 环境下载约 3.60 GiB，均支持检测、断点续传、校验、修复和删除。GPU 需要兼容的 NVIDIA 驱动。全部模型约 0.8 GB，视频运行缓存另计。
python -m venv .venv-cpu
.venv-cpu\Scripts\python -m pip install -r requirements-cpu.txt
.venv-cpu\Scripts\python main.py
.venv-cpu\Scripts\python -m unittest discover -s tests -v
.venv-cpu\Scripts\python main.py --self-test E:\OpenPre-test完整模型测试设置 OPENPRE_TEST_ALL=1、OPENPRE_TEST_DEVICE=cpu 或 cuda，并将 OPENPRE_TEST_MODELS 指向模型目录。
构建见 packaging/build.ps1；研究与设计见 docs/architecture.md。
构建前请按 bin/README.md 准备 FFmpeg 的 ffmpeg.exe 和 ffprobe.exe；它们是第三方构建输入，不随源码仓库提交。
第三方与模型各自许可见 THIRD_PARTY_NOTICES.md、licenses/。分割模型与部分姿态相关代码有用途限制，OpenPre 不改变上游许可。