Hanafubuki

PyTorch 管理

检查当前 PyTorch 与设备的兼容性,并按自动或手动方案重新安装。

“PyTorch”页会检查实例 Python 中的 Torch 组件、检测到的设备类型,并列出当前 WebUI 支持的安装组合。不同 WebUI、操作系统和硬件看到的选项可能不同。

理解检查结果

状态含义
兼容当前构建符合检测到的设备和 WebUI 规则
不兼容已安装构建与设备或支持组合不匹配
未安装实例环境中没有检测到所需 PyTorch 软件包
无法检查Python、管理 API 或环境查询失败

页面还会显示 Torch、TorchVision、TorchAudio、xFormers 等已检测版本,以及推荐设备构建。版本名称以页面当前目录为准,不要从其他 WebUI 的教程直接复制安装命令。

重新安装 PyTorch

停止 WebUI

PyTorch 重装会修改正在使用的 Python 环境,因此需要先停止 WebUI。管理 API 会由应用协调,不需要手动结束它。

选择版本方式

普通用户选择“自动选择”,让安装任务根据硬件决定组合。只有明确知道驱动、CUDA、ROCm 或 CPU 需求时才使用“手动选择”。

决定是否强制重装

当前状态已经兼容时,通常不勾选“即使当前版本正确也重新安装”。只有文件损坏、依赖异常或需要重新部署同一构建时才启用。

确认并等待任务

点击“重新安装 PyTorch”,确认后在右下角状态区或任务中心查看依赖下载、安装和环境检查输出。

验证结果

任务完成后刷新本页,确认状态为“兼容”并核对已安装构建,再启动 WebUI 完成实际运行验证。

失败处理

  • 自动选择失败时,先检查显卡驱动、操作系统支持和页面报告的检测设备,不要随意尝试多个 CUDA/ROCm 构建。
  • 下载或解析软件包失败时,检查网络与代理镜像
  • 安装后仍不兼容时,打开最近任务输出,记录选择的构建、退出码和环境检查结果。
  • 启动时出现 PyTorch 决策窗口,可以取消并回到本页修复;“忽略并启动”只用于你能接受本次运行风险的情况。

重新安装会替换核心依赖

该操作会修改当前实例 Python 中的 PyTorch 及配套软件包。不要同时在实例终端手动安装 Torch,也不要在任务完成前启动 WebUI。

本页目录