ml-stable-diffusion

在 Mac 和 iPhone 上本地跑 Stable Diffusion,离线出图。

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 图像生成 🍴 复刻 1080 🐛 待处理 192 👀 关注 139
GitHub ↗
GitHub 星标 ★ 17967
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自行部署

项目预览

ml-stable-diffusion 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类图像生成
开发团队apple-aiml-research
定价模式🏷️完全免费
价格说明开源免费,需自行部署
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
GitHub 星标★ 17967
上线时间2022-11-16 00:00:00
代码更新2026-09-11
仓库体积23.6 MB
本站数据更新2026-11-02
维护状态维护中
收录时间2026-09-18
浏览次数2

项目介绍

ml-stable-diffusion 是苹果官方开源的 Stable Diffusion 推理实现,专门面向 Apple Silicon 芯片(M1/M2/M3 系列)优化。它把原本依赖 NVIDIA GPU 的扩散模型转换为 Core ML 格式,让 Mac、iPhone、iPad 等设备无需独立显卡即可本地生成图像。项目提供模型转换脚本、Swift 与 Python 推理示例,并支持 PyTorch 权重到 Core ML 的完整流水线,用户可自行转换任意 Stable Diffusion 模型。核心能力包括:利用 Apple Neural Engine 与 GPU 加速、支持图像到图像、文本到图像、负向提示词、无分类器引导、多步采样调度器,以及量化压缩以降低内存占用。它解决的是苹果生态缺少高效本地扩散模型推理方案的问题,让开发者能在端侧离线运行生成式 AI,兼顾隐私与速度。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-18 · 当前星标 ★ 17967

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:进阶 约 10 分钟 部署方式:本地安装 5 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • macOS 13.1 或更高版本(模型转换与项目构建)
  • Python 3.8(用于模型转换)
  • coremltools 7.0(用于模型转换)
  • Xcode 14.3 与 Swift 5.8(用于构建 Swift 项目)
  • 目标设备:macOS 13.1+,iPadOS/iOS 16.2+(内存优化版需 macOS 14.0+ / iOS 17.0+)

安装与启动步骤

  1. 1检查系统版本

    确保 macOS 版本满足要求,不同用途版本要求不同。

  2. 2安装转换依赖

    安装 Python 3.8 和 coremltools 7.0,用于将 PyTorch 模型转换为 Core ML。

  3. 3转换模型

    使用 python_coreml_stable_diffusion 包转换模型,生成 Core ML 模型文件。

  4. 4构建 Swift 项目

    使用 Xcode 14.3 和 Swift 5.8 构建 StableDiffusion 包。

  5. 5运行 CLI 示例

    使用转换后的模型生成图像,替换资源路径和输出路径。

    swift run StableDiffusionSample "a photo of an astronaut riding a horse on mars" --resource-path /your/path/to/mlpackages/Resources/ --seed 93 --output-path /your/path/to/output/image

如何确认成功

运行 CLI 示例后,在输出路径生成以提示词和种子命名的 PNG 图片。

常见问题

Q:支持哪些设备?

A:支持 Apple Silicon 芯片的 Mac、iPhone、iPad,需满足系统版本要求。

Q:内存不足怎么办?

A:在 iOS 上构造 StableDiffusionPipeline 时设置 reduceMemory 为 true。

Q:输出文件如何命名?

A:根据提示词和随机种子命名,如 a_photo_of_an_astronaut_riding_a_horse_on_mars.93.final.png。

注意事项

  • 仅支持 Apple Silicon 芯片,Intel Mac 不可用。
  • 转换模型需要满足 macOS 13.1、Python 3.8 和 coremltools 7.0。
  • 构建 Swift 项目需要 Xcode 14.3 和 Swift 5.8。
  • 目标设备运行时版本要求见系统需求。

核心亮点

  • 苹果官方维护,与 Core ML、ANE 深度适配,性能与兼容性有保障
  • 提供完整转换脚本和 Swift/Python 示例,从 PyTorch 到端侧部署链路清晰
  • 支持量化与多种采样器,可在移动端内存受限环境下运行

不足之处

  • 仅面向 Apple 平台,无法在 Windows/Linux 或非苹果芯片上使用
  • 转换流程对新手仍有一定门槛,模型版本兼容性需自行验证

适用场景

  • Mac 用户在本地离线生成插画或概念图,保护隐私
  • iOS 开发者在 App 中集成端侧 AI 绘图功能
  • 研究人员在 Apple Silicon 上做扩散模型推理性能测试

替代项目

diffusers、stable-diffusion-webui

同类项目推荐

nanobanana-trending-prompts 开源

1400+热门AI绘图提示词,按热度排序,即拿即用

1,400+ curated trending AI image prompts from X, ranked by engagement. Works with Na···

★ 747 2026-08-09
story-iter 开源

免训练迭代框架,让长故事图像生成角色不崩、情节连贯。

[ICLR 2026] A Training-free Iterative Framework for Long Story Visualization

★ 958 2026-08-09
sd-webui-depth-lib 开源

一键生成深度图,让 ControlNet 构图更精准

Depth map library for use with the Control Net extension for Automatic1111/stable-di···

★ 1388 2026-08-09
DiffMorpher 开源

用扩散模型让两张图丝滑变形,生成高质量过渡视频

Official Code for DiffMorpher: Unleashing the Capability of Diffusion Models for Ima···

★ 510 2026-08-09
worker-a1111 开源

把 A1111 跑在 serverless 上,按需调用,省钱省心

Automatic1111 serverless worker.

★ 100 2026-08-09
Infographic 开源

输入文字,AI 自动生成专业信息图,省时省力。

An Infographic Generation and Rendering Framework, bring words to life with AI!

★ 7060 2026-08-09
InfiniteYou 开源

换脸不换人,照片随心改,身份永不变

[ICCV 2025 Highlight] InfiniteYou: Flexible Photo Recrafting While Preserving Your I···

★ 2688 2026-08-09