
ml-stable-diffusion
在 Mac 和 iPhone 上本地跑 Stable Diffusion,离线出图。
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-18 · 当前星标 ★ 17967
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 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检查系统版本
确保 macOS 版本满足要求,不同用途版本要求不同。
-
2安装转换依赖
安装 Python 3.8 和 coremltools 7.0,用于将 PyTorch 模型转换为 Core ML。
-
3转换模型
使用 python_coreml_stable_diffusion 包转换模型,生成 Core ML 模型文件。
-
4构建 Swift 项目
使用 Xcode 14.3 和 Swift 5.8 构建 StableDiffusion 包。
-
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···
story-iter
开源
免训练迭代框架,让长故事图像生成角色不崩、情节连贯。
[ICLR 2026] A Training-free Iterative Framework for Long Story Visualization
sd-webui-depth-lib
开源
一键生成深度图,让 ControlNet 构图更精准
Depth map library for use with the Control Net extension for Automatic1111/stable-di···
DiffMorpher
开源
用扩散模型让两张图丝滑变形,生成高质量过渡视频
Official Code for DiffMorpher: Unleashing the Capability of Diffusion Models for Ima···
worker-a1111
开源
把 A1111 跑在 serverless 上,按需调用,省钱省心
Automatic1111 serverless worker.
Lucy-Edit-ComfyUI
开源
在 ComfyUI 里用一句话指令改图
Infographic
开源
输入文字,AI 自动生成专业信息图,省时省力。
An Infographic Generation and Rendering Framework, bring words to life with AI!
stable-diffusion-webui-prompt-tr···
开源
在提示词间平滑游走,一键生成伪动画视频
Travel between prompts in the latent space to make pseudo-animation, extension scrip···
InfiniteYou
开源
换脸不换人,照片随心改,身份永不变
[ICCV 2025 Highlight] InfiniteYou: Flexible Photo Recrafting While Preserving Your I···