开源项目使用教程:ADI-Stable-Diffusion
1. 项目介绍
ADI-Stable-Diffusion 是一个基于 ONNXRuntime 和 C++ 的高性能、跨平台 Stable Diffusion 推理库。它旨在利用 ONNXRuntime 的加速能力和 .onnx 模型格式的高兼容性,为 Stable Diffusion 的工程部署提供一个方便的解决方案,同时具有合适的包大小和高性能。
特点:
- 开源:ONNXRuntime 是一个开源项目,用户可以自由使用和修改以满足不同的应用场景。
- 可扩展性:它支持自定义操作符和优化,根据具体需求进行扩展和优化。
- 高性能:ONNXRuntime 高度优化,提供快速的推理速度,适合实时应用。
- 强兼容性:支持从多个深度学习框架(如 PyTorch、TensorFlow)转换模型,方便集成和部署。
- 跨平台支持:支持 CPU、GPU、TPU 等多种硬件平台,实现在不同设备上的高效执行。
- 社区和企业支持:由 Microsoft 开发和维护,拥有活跃的社区和企业支持,提供持续的更新和维护。
2. 项目快速启动
安装 CLI 工具
使用包管理器安装命令行工具
-
macOS (Homebrew):
brew tap windsander/adi-stable-diffusion brew install adi
-
Windows (git-Bash + Chocolatey):
curl -L -o adi.1.0.1.nupkg "https://raw.githubusercontent.com/Windsander/ADI-Stable-Diffusion/deploy/adi.1.0.1.nupkg" choco install adi.1.0.1.nupkg -y
从发布版本下载
您可以从 Release Assets 找到最新可用的版本。包的结构如下:
--bin
--adi
--lib
--[相应平台的 ADI 库,例如 libadi.a]
--[相应平台的 ORT 库,例如 libonnxruntime.dylib]
--include
--adi.h
--CHANGELOG.md
--README.md
--LICENSE
解压后,您可以简单地将 bin
和 lib
目录安装到系统中,或者直接进入解压后的 bin
目录,开始使用 adi
。
本地构建
提供了一个自动化脚本来更容易地在您的设备上编译 ADI。 简单地执行脚本 auto_build.sh
:
# 如果您没有传递 BUILD_TYPE 参数,脚本将使用默认的 Debug 构建类型。
# 如果您没有通过 [选项] 启用某些 ORTProvider,脚本将根据平台选择默认的 ORTProvider
bash ./auto_build.sh
-
示例-MacOS:
bash ./auto_build.sh --platform macos --build-type debug
-
示例-Windows:
bash ./auto_build.sh --platform windows --build-type debug
-
示例-Linux(Ubuntu):
bash ./auto_build.sh --platform linux --build-type debug
-
示例-Android:
bash ./auto_build.sh --platform android \ --build-type debug \ --android-ndk /Volumes/AL-Data-W04/WorkingEnv/Android/sdk/ndk/26.1.10909125 \ --android-ver 27
-
示例(带有额外选项): 如下,构建 release 版本,启用 CUDA 和 TensorRT,并自定义编译器配置
bash ./auto_build.sh --build-type release --cuda=ON --tensorrt=ON
3. 应用案例和最佳实践
(此处根据实际项目情况,提供具体的应用案例和最佳实践。)
4. 典型生态项目
(此处可以列出与 ADI-Stable-Diffusion 相关的生态项目,以及它们之间的关系和应用场景。)
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考