mac m3 pro 部署 stable diffusion webui

news2025/4/21 8:21:41

什么是Stable Diffusion WebUI ？

Stable Diffusion WebUI 是一个基于Stable Diffusion模型开发的图形用户界面（GUI）工具。通过这个工具，我们可以很方便的基于提示词，描述一段文本来指导模型生成相应的图像。相比较通过编码或者命令方式使用stable diffusion生成图像，webui更具灵活性与方便性，同时不具备编码能力的人员也能轻松使用

部署前的说明

最好的资源在官网，目前SD webui（Stable Diffusion WebUI 简称，本文后续都使用简称表述）托管在github上，我们可以从 AUTOMATIC1111 维护的仓库中下载并自行部署。对mac电脑可以参照这篇说明部署：Installation on Apple Silicon · AUTOMATIC1111/stable-diffusion-webui Wiki · GitHub。这里将部署过程以、部署过程中遇到问题及解决方案，再重新整理说明下，以便后续对在mac上部署SD webui 的同学有参考意义。

部署过程

安装homebrew

首先确保你的mac电脑安装了homebrew，homebrew是mac上一款功能强大的软件包管理器，安装过程比较简单，可直接参考官网提示安装，传送门==> homebrew。

安装sd依赖软件

homebrew安装好后，打开终端控制台，执行以下命令安装依赖的软件。这里需要注意下python的版本为3.10，如果你的电脑安装了其他版本的python（一般mac都默认自带python），请卸载避免冲突，或者设置python、pip命令默认使用brew 安装的3.10版本

brew install cmake protobuf rust python@3.10 git wget

这里笔者电脑默认有个3.9.6版本的python，为避免冲突，通过强制在 ~/.bash_profile文件中设置使用brew安装的3.10版本实现。注意文件修改后，需要source生效。

alias python=/opt/homebrew/bin/python3.10
alias python3=/opt/homebrew/bin/python3.10
alias pip=/opt/homebrew/bin/pip3.10
alias pip3=/opt/homebrew/bin/pip3.10

克隆SD webui软件包

接下来就是克隆 SD webui 项目到本地，选定一个文件夹后，直接执行git clone即可。

git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui

下载完成后进入到 stable-diffusion-webui 目录下，执行 ./webui.sh 命令启动即可。由于默认的项目不带模型的，我们还需要相关模型。guthub上的模型链接都是在 https://huggingface.co/ 上的，由于国内网络限制原因，无法访问到huggingface，故只能去镜像网站手动下载放到项目中指定的目录下。这里我们去镜像网站 HF-Mirror 或者模搭社区下载 v1-5-pruned-emaonly.safetensors 模型，下载完的模型放到项目中的 /stable-diffusion-webui/models/Stable-diffusion/ 目录下即可，再次重新启动。

重新执行 ./webui.sh 后，可以看到执行仍报如下错误，无法加载 openai/clip-vit-large-patch14，原因还是网络问题无法访问https://huggingface.co导致。

EnvironmentError(
OSError: Can't load tokenizer for 'openai/clip-vit-large-patch14'. If you were trying to load it from 'https://huggingface.co/models', make sure you don't have a local directory with the same name. Otherwise, make sure 'openai/clip-vit-large-patch14' is the correct path to a directory containing all relevant files for a CLIPTokenizer tokenizer.

这里我们仍然可以从镜像网站 HF-Mirror 下载对应的模型，注意这里下载的模型放到项目根目录即可，同时相关的配置文件也要一并下载，如下图所示。