StableSR

环境要求

• Python 环境（README 未指定具体 Python 版本）
• PyTorch == 1.12.1
• CUDA == 11.7（需 NVIDIA GPU）
• pytorch-lightning == 1.4.2
• xformers == 0.0.16（可选）

安装与启动步骤

1. 1克隆项目仓库

   从 GitHub 拉取 StableSR 源码到本地，后续安装都在该目录内进行。

   git clone https://github.com/IceClear/StableSR.git
   cd StableSR

   复制

2. 2创建依赖环境

   README 说明其余依赖都在 environment.yaml 中，用它创建 conda 环境可一次性装齐。

   conda env create -f environment.yaml

   复制

3. 3安装 xformers

   xformers 在 README 中标注为 Optional，装上可加速并降低显存占用，不装也能运行。

   conda install xformers -c xformers/label/dev

   复制

4. 4安装 taming 与 CLIP

   这两个依赖需从 GitHub 源码安装，README 给出了对应的 pip -e 命令。

   pip install -e git+https://github.com/CompVis/taming-transformers.git@master#egg=taming-transformers
   pip install -e git+https://github.com/openai/CLIP.git@main#egg=clip

   复制

5. 5安装项目本体

   在仓库根目录执行可编辑安装，注册本项目包及其依赖。

   pip install -e .

   复制

6. 6准备模型权重与推理

   README 未给出具体推理命令，需按仓库内说明下载预训练权重后运行示例脚本。

如何确认成功

按 README 的 Running Examples 章节运行推理脚本，能对低分图输出 4x 超分结果即成功。

常见问题

注意事项

• 环境版本需与 README 对齐：PyTorch 1.12.1 + CUDA 11.7 + pytorch-lightning 1.4.2。
• README 未给出模型权重下载地址与推理脚本参数，需自行查阅仓库内文件。
• 建议使用 conda 独立环境，避免与已有 PyTorch 环境冲突。
• WebUI 与 ComfyUI 为第三方独立仓库，安装方式不同。