Comfy-Topaz-Photo

ComfyUI Node for Topaz Photo AI (ComfyTopazPhoto)

Topaz Photo AI Sample

Integrate Topaz Photo AI's powerful image enhancement capabilities directly into your ComfyUI workflows.

This node allows you to call the tpai.exe command-line interface from within ComfyUI to apply enhancements offered by Topaz Photo AI through its Autopilot settings.

重要更新: v1.0.0 版本发布

我们很高兴地宣布 ComfyTopazPhoto 节点 v1.0.0 版本正式发布！此版本解决了多个关键问题并大幅提升了稳定性：

• 全新图像格式处理系统：现在支持多种 PyTorch 张量格式，能够正确处理 ComfyUI 中的各种图像格式
• 智能输出文件检测：新增 find_output_file 功能，能够在 Topaz 使用不同命名规则时仍能找到输出文件
• 出错后自动恢复：添加了重试机制和更好的异常处理，确保在遇到问题时能继续工作
• 更详细的日志输出：便于排查问题和了解处理过程

该扩展现已完全简化，专注于通过 Topaz Photo AI CLI 使用 Autopilot 设置进行基本图像处理。所有增强参数现在应该通过 Topaz Photo AI GUI 中的 Autopilot 设置进行配置。

Requirements

• Licensed installation of Topaz Photo AI: This node requires a working installation of Topaz Photo AI, specifically the tpai.exe executable.
• Topaz Photo AI Models: Ensure that Topaz Photo AI has successfully downloaded the necessary AI models. You can usually verify this by running the main Topaz Photo AI application.

Installation

1. Clone this repository into your ComfyUI/custom_nodes/ directory:

   git clone https://github.com/leoleelxh/Comfy-Topaz-Photo
   

2. Alternatively, download the repository contents as a ZIP file and extract it into ComfyUI/custom_nodes/Comfy-Topaz-Photo.

3. Restart ComfyUI.

使用流程详解

完整工作流程

使用 ComfyTopazPhoto 的完整流程包括以下几个步骤：

1. 安装前准备

   • 确保 Topaz Photo AI 正确安装并激活
   • 确认 AI 模型已正确下载（可以通过打开 Topaz Photo AI 并处理一张测试图像来验证）
   • 确认 tpai.exe 的正确路径（通常在 C:\Program Files\Topaz Labs LLC\Topaz Photo AI\tpai.exe）

2. 配置 Autopilot 设置

   • 打开 Topaz Photo AI 应用程序
   • 进入 Preferences -> Autopilot
   • 根据需要配置增强参数：
     • Upscale & Resize: 选择放大比例（2x、4x等）
     • Face Recovery: 调整面部恢复强度
     • Sharpen: 调整锐化程度
     • Denoise: 设置降噪级别
     • 文字恢复: 如需要，启用文字恢复功能
   • 保存设置（这些设置将在 CLI 调用中使用）

3. ComfyUI 工作流设置

   • 在 ComfyUI 中，添加以下节点：
     • 图像源节点（例如 Load Image、VAE Decode 等）
     • Topaz Photo AI 节点：主处理节点
   • 连接图像源到 Topaz Photo AI 节点的 images 输入
   • 配置 Topaz Photo AI 节点参数：
     • tpai_exe: 设置 Topaz Photo AI 的可执行文件路径（例如 C:\Program Files\Topaz Labs LLC\Topaz Photo AI\tpai.exe）
     • output_format: 选择输出格式（jpg、png、tif等）
     • quality: 设置 JPEG 质量（对于jpg格式）
     • overwrite: 是否覆盖已存在的文件
     • output_prefix: (可选) 自定义输出文件前缀

4. 运行处理

   • 运行工作流
   • ComfyUI 会自动调用 Topaz Photo AI 对图像进行处理
   • 处理完成后，增强后的图像将在 ComfyUI 中显示

5. 故障排除（如需）

   • 如果遇到问题，可以在 ComfyUI 中添加 Test & Clean Topaz 节点
   • 设置 tpai_exe 为 Topaz Photo AI 的可执行文件路径
   • 设置 clean_cache 为 True 清理缓存
   • 设置 verbose 为 True 获取详细日志
   • 运行此节点测试 Topaz Photo AI 安装情况并清理缓存

实际使用案例

基本图像增强工作流

[Load Image] --> [Topaz Photo AI] --> [Preview Image]

在这个简单工作流中：

1. 加载图像
2. 通过 Topaz Photo AI 节点处理（使用 Autopilot 预设的增强参数）
3. 预览结果

与其他 ComfyUI 节点结合使用

[Load Image] --> [其他处理节点] --> [Topaz Photo AI] --> [后续处理节点] --> [Preview Image]

例如，你可以：

1. 使用 ComfyUI 的 SD 生成图像
2. 应用其他效果
3. 使用 Topaz Photo AI 进行最终的增强处理
4. 应用后期处理效果
5. 保存或预览结果

视觉流程示例

下面是一个简单的 ComfyUI 工作流程图示例：

+------------------+
| Load Image       |
+--------+---------+
         |
         v
+--------+---------+     +------------------+
| Topaz Photo AI   |     | Test & Clean     |
| tpai_exe: C:\... |     | tpai_exe: C:\... |
| output_format:jpg|     | clean_cache: True|
| quality: 95      |     +------------------+
+--------+---------+
         |
         v
+--------+---------+
| Preview Image    |
+------------------+

关键使用说明

• 必须正确设置 tpai_exe 路径：这是 Topaz Photo AI 可执行文件的完整路径，例如 C:\Program Files\Topaz Labs LLC\Topaz Photo AI\tpai.exe
• 所有增强参数都通过 Topaz Photo AI 的 Autopilot 设置控制，而不是通过 ComfyUI 节点参数
• Topaz Photo AI 应用程序和 ComfyUI 可以同时运行，但不要在 ComfyUI 处理图像时修改 Autopilot 设置
• 处理大图像可能需要较长时间，请耐心等待
• 所有临时文件会自动清理

节点详情

Topaz Photo AI 节点

输入:

• images: 要处理的输入图像
• tpai_exe: Topaz