安全稳定ckpt转safetensors工具GUI版完整使用指南
项目地址: https://gitcode.com/gh_mirrors/sa/Safe-and-Stable-Ckpt2Safetensors-Conversion-Tool-GUI Safe-and-Stable-Ckpt2Safetensors-Conversion-Tool-GUI是一个专为Stable Diffusion用户设计的图形界面工具，能够快速安全地将模型检查点文件在ckpt和safetensors格式之间互相转换。该工具采用直观的图形界面，无需编程基础即可轻松完成模型格式转换。
项目概述
该项目提供了一个安全稳定的模型格式转换解决方案，主要功能包括：
- 支持.ckpt文件转换为.safetensors格式
- 支持.safetensors文件转换回.ckpt格式
- 内置文件浏览器便于操作
- 支持添加后缀名避免覆盖原文件
- 文件哈希值检查功能
环境配置
方法一：使用requirements.txt安装依赖 在项目根目录下运行：
pip install -r requirements.txt
方法二：使用conda环境 通过conda.yaml文件创建完整的环境：
conda env create -f conda.yaml
快速启动
配置好环境后，只需运行以下命令即可启动GUI界面：
python run_app_gui.py
核心功能详解
文件转换功能
工具支持两种转换模式：
- 单文件转换：选择单个文件进行转换，自动识别源格式并转换为对应格式
- 目录批量转换：选择整个目录，指定目标格式进行批量转换
后缀名设置
勾选"Add Suffix"复选框后，输出文件将自动添加"-cnvrtd"后缀，避免覆盖原始文件。如不勾选，转换后的文件将直接覆盖原文件。
哈希值验证
工具会在转换过程中显示文件的哈希值，帮助用户验证文件完整性和一致性。需要注意的是，ckpt文件转换为safetensors格式后哈希值会发生变化，但在两种格式之间来回转换时哈希值将保持一致。
操作界面介绍
安全稳定ckpt转safetensors工具主界面
界面主要分为三个区域：
- 顶部区域：包含操作按钮和文件类型选择
- 中部区域：文件浏览器和转换选项
- 底部区域：进度条和状态显示
使用注意事项
-
安全提醒：转换过程需要先加载.ckpt数据，这意味着可能加载pickle文件。建议仅对安全模型使用此工具，或在线转换模型以避免潜在的安全问题。
-
文件验证：在删除原始.ckpt文件之前，请务必检查转换后的模型是否正常工作。
-
哈希值变化：ckpt文件转换为safetensors格式时，由于文件结构的变化，哈希值会发生改变。但在两种格式之间来回转换时，哈希值将保持一致。
项目文件结构说明
run_app_gui.py- 应用程序主入口文件CONSTANTS.py- 常量定义文件，包含路径设置和参数配置requirements.txt- pip环境依赖配置文件conda.yaml- conda环境配置文件util/- 工具函数目录，包含颜色配置、文件扩展名定义、哈希计算等功能模块
技术特点
该工具基于PySimpleGUI开发，提供了现代化的暗色主题界面，用户体验友好。支持文件浏览、格式选择、进度显示等完整功能，让模型格式转换变得简单直观。
通过本工具，用户可以轻松管理Stable Diffusion模型文件，在安全性和性能之间找到最佳平衡点。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
