Deforum 稳定扩散
⚠️ 注意:本项目已不再维护。 ⚠️
此存储库不再积极维护或更新。建议用户寻找替代解决方案或者如果希望继续开发,可以复刻该项目。
欢迎来到 Deforum 稳定扩散!
目录
简介
我们是一群热衷于让稳定扩散机器学习图像合成技术普及到每个人的程序员和艺术家社区。我们的开源项目旨在免费使用,并且易于根据自定义需求和流程进行修改。我们相信协作的力量,并不断一起努力改进和发展我们的稳定扩散实现。无论你是经验丰富的开发者还是刚刚入门,我们都邀请你加入我们,成为这个激动人心项目的一份子。
现在你也可以在 Replicate 上轻松运行 Deforum 稳定扩散,查看网页演示和 API 请点击这里
主要特性
- 我们的实现是用 IPython notebook 编写的,专为 Google Colab 使用而设计。
- 为应对积分系统的实施,我们增加了对本地运行时的支持,并将添加网页用户界面。
- 该 notebook 包含多种功能,用于生成插值、2D 和 3D 动画以及 RANSAC 动画。
- 我们还提供 CLIP、美学和色彩调色板条件设置。
- 我们的目标是为用户提供一系列工具和选项来创建稳定扩散图像。
开始之前
在开始安装和使用 Deforum 稳定扩散之前,你需要做以下几件事:
-
安装 ffmpeg。FFmpeg 是一个免费的软件项目,用于处理多媒体数据的库和程序。你需要它来处理音频和视频文件。按照网站上的说明下载并安装 FFmpeg 到你的系统上(https://ffmpeg.org/ffmpeg.html)。安装完成后,确保它在你的 PATH 中,在终端中运行
ffmpeg -h
。如果没有收到错误消息,就说明安装成功。这里有一个 Windows 系统的安装指南 (https://phoenixnap.com/kb/ffmpeg-windows)。 -
安装最新的 NVIDIA 驱动程序,以支持 CUDA 11.7(Windows 用户可能不需要)。NVIDIA CUDA 是一个并行计算平台和编程模型,使开发人员能够利用 NVIDIA 图形处理单元 (GPU) 的力量来加速计算密集型任务。你需要安装最新的 NVIDIA 驱动程序才能使用 Deforum 稳定扩散。你可以在这里找到驱动程序。按照网站上的说明下载并安装驱动程序。
-
创建一个 huggingface token。Hugging Face 是一个自然语言处理平台,提供最先进的模型和工具。你需要创建一个 token 才能使用 Deforum 稳定扩散中的一些自动模型下载功能。按照 Hugging Face 网站上的说明创建 token。
-
安装 Anaconda。Anaconda 是 Python 和 R 的免费开源发行版。它包含一个名为 conda 的包管理器,可以轻松安装和管理 Python 环境和包。按照 Anaconda 网站上的说明下载并安装 Anaconda 到你的系统上。
-
为你的系统安装 Git。Git 是一个版本控制系统,可以帮助你跟踪代码变更并与其他开发者协作。你可以通过在终端中运行
conda install -c anaconda git -y
来使用 Anaconda 安装 Git。如果你在通过 Anaconda 安装 Git 时遇到问题,可以使用以下链接:
完成这些步骤后,你就可以开始安装 Deforum 稳定扩散了。
入门指南
要安装 Deforum 稳定扩散,请按照以下步骤操作:
- 为 Deforum 创建一个合适的 anaconda 环境并激活它:
conda create -n dsd python=3.10 -y
conda activate dsd
- 克隆这个 GitHub 仓库并进入它:
git clone https://github.com/deforum-art/deforum-stable-diffusion.git
cd deforum-stable-diffusion
- 使用安装脚本安装所需的包:
python install_requirements.py
- 通过运行 Python 脚本检查你的安装:
python Deforum_Stable_Diffusion.py
运行 Deforum
运行Deforum Stable Diffusion有四种方式:本地运行.py文件、本地运行Jupyter、通过Colab本地运行,以及在Colab服务器上运行。
本地运行
要在本地运行Deforum Stable Diffusion,确保激活了dsd conda环境:
conda activate dsd
然后导航到stable-diffusion文件夹,运行Deforum_Stable_Diffusion.py或Deforum_Stable_Diffusion.ipynb文件。运行.py文件是检查安装是否正常的最快捷简便方法,但它不是调试提示和设置的最佳环境。
python Deforum_Stable_Diffusion.py
如果你更喜欢类似Colab的体验,可以在Jupyter Lab或Jupyter Notebook中运行.ipynb文件。在stable-diffusion文件夹中激活Jupyter Lab或Jupyter Notebook,使用以下任一命令:
jupyter-lab
或
jupyter notebook
Colab本地运行时
要使用Colab本地运行时运行Deforum Stable Diffusion,确保激活了dsd conda环境:
conda activate dsd
然后,打开Google Colab,选择"文件 > 上传笔记本",选择stable-diffusion文件夹中的.ipynb文件。通过运行以下命令启用Jupyter扩展:
jupyter serverextension enable --py jupyter_http_over_ws
运行以下命令启动服务器:
jupyter notebook --NotebookApp.allow_origin='https://colab.research.google.com' --port=8888 --NotebookApp.port_retries=0
复制粘贴提供的URL和令牌到浏览器以访问Jupyter笔记本。
重新开始
如果需要从头开始,可以删除stable-diffusion文件夹并使用以下命令删除dsd conda环境:
conda deactivate
conda env remove -n dsd
删除dsd环境后,你可以重新开始全新安装。
自定义
Deforum Stable Diffusion提供了广泛的自定义和配置选项,让你可以轻松根据特定需求和偏好调整输出。主推理笔记本中有超过100种不同设置可用,可能性无穷无尽。
有关如何自定义和配置Deforum Stable Diffusion的更多详细信息,请查看指南并关注即将推出的wiki。如果在使用Deforum Stable Diffusion时遇到任何问题,可以尝试以下几点:
- 确保已安装所有必需的依赖项并正确遵循安装说明。
- 查看示例文件夹以获取指导。
- 查看最新的用户指南以获取故障排除提示和解决方案。
- 如果仍然找不到解决方案,随时联系乐于助人且知识渊博的Deforum Discord。
贡献
我们欢迎任何经验水平的人为Deforum Stable Diffusion做出贡献。如果你有兴趣贡献,请联系Deforum Discord的开发人员以获取更多信息。
所有贡献都通过GitHub管理,我们为正在进行的功能维护分支。我们遵循GitFlow分支模型,dev分支作为主要集成分支。
在提交拉取请求之前,请确保:
- 编写清晰、简洁且文档完善的代码。
- 遵循项目中使用的编码风格和约定。
- 彻底测试你的更改以确保它们按预期工作。
支持我们
Deforum Stable Diffusion是一个社区驱动的开源项目,可以免费使用和修改。我们依靠用户的支持来维持项目运行并帮助我们改进。如果你想支持我们,可以在我们的Patreon页面上捐款。任何金额,无论大小,我们都非常感谢!
你的支持帮助我们支付托管、开发和维护的费用,并允许我们投入更多时间和资源来改进Deforum Stable Diffusion。感谢你的支持!
此readme是与chat-gpt合作编写的