Install doesn’t work on Mac

快速结论：这个报错通常发生在 macOS 用户尝试用 Docker 方式启动 SwarmUI 时，Docker 无法从 CDI 发现可用的 GPU 厂商。优先确认你走的到底是官方 Mac 安装指引还是 Docker 指引，Mac 支持本身属于社区贡献且未充分测试。

适用环境：macOS；Docker Desktop for Mac；SwarmUI；涉及 Apple Silicon（Issue 中用户提到希望支持 M 系列架构）。Issue 未确认具体的 Python、CUDA、PyTorch 或显卡版本。

最快修复方案：暂无确认的一步修复方案。Issue 中维护者明确表示不要在 Mac 上使用 Docker 安装路径，该章节基本是占位符。

注意事项：维护者指出 Docker 报错信息来自 Docker 本身，并且 Swarm 安装指引从未针对 Mac 用户推荐 Docker；Mac 支持为社区贡献，未经过充分测试。此外有用户反馈普通 Mac 安装路径也存在问题，因此不要假设改用非 Docker 方式一定成功。

问题场景

用户在 macOS 上安装 SwarmUI 时触发问题。用户分别尝试了普通安装和 Docker 安装两种方式，两种方式都失败。其中 Docker 方式在解包 swarmui:latest 镜像后启动容器时报错，无法发现 GPU 厂商。

报错原文

docker: Error response from daemon: failed to discover GPU vendor from CDI: no known GPU vendor found

用户在 Issue 中给出的相关日志片段：

=> => unpacking to docker.io/library/swarmui:latest 3.4s
docker: Error response from daemon: failed to discover GPU vendor from CDI: no known GPU vendor found

原因分析

可能原因：该报错来自 Docker 的容器启动阶段，Docker 尝试通过 CDI（Container Device Interface）识别 GPU 厂商，但在 macOS 环境下没有发现已知 GPU 厂商，于是拒绝启动容器。

维护者在回复中强调：这些是 Docker 侧的消息，且 SwarmUI 的安装指引并未针对 Mac 用户推荐 Docker；如果用户看到任何声称是 Swarm 的 Docker 包，那不是官方合法的。Issue 讨论中还确认，Mac 上 Docker 安装章节目前基本是留给有开发能力的 Mac 用户补充的占位内容，属于未测试状态。

环境排查

确认当前使用的是 macOS，以及芯片类型是否为 Apple Silicon（M 系列）。
确认是通过官方安装指引安装，还是按照 Docker 章节安装。
确认 Docker Desktop for Mac 的版本与运行状态。
确认 SwarmUI 来源是否为官方仓库，避免使用第三方声称的 Docker 包。
Issue 未提供 Python、CUDA、PyTorch、显卡驱动或具体依赖版本，因此无法据此判断这些环境项。

解决步骤

先确认你参照的是哪一份安装说明。维护者给出的 Mac 安装入口是官方 README 的 Installing on Mac 章节，而不是 Docker 章节。
如果你正按 Docker 章节在 Mac 上启动，建议停止该路径。维护者明确表示不要在 Mac 上这样做，Docker 章节在 Mac 场景下基本是未测试的占位内容。
如果仍想尝试 Mac 上运行 SwarmUI，只能回到官方 Mac 安装指引继续排查；但 Issue 中用户反馈普通 Mac 安装同样存在问题，维护者未在讨论中给出已验证的修复步骤。
确认你使用的 SwarmUI 来自官方仓库而非第三方 Docker 包，避免引入来源不明的镜像。
关于 Issue 中提到的 SixLabors.ImageSharp 3.1.12 漏洞警告，维护者说明这是有意保留旧版本，等待替换为其他图像库；相关漏洞警告不影响 Swarm。这属于旁支讨论，不是本次安装失败的直接原因。

验证方法

目前 Issue 中没有给出可验证的成功修复结果，因此无法提供确定的验证标准。可确认的状态是：不再出现 failed to discover GPU vendor from CDI: no known GPU vendor found 这类 Docker 启动报错，并且 SwarmUI 能正常启动。但由于 Mac 支持本身未充分测试，是否能稳定运行仍需自行验证。