--------------------------------------------------------------------------------

# <div align="center"><strong>diffusers</strong></div>
## 简介
Diffusers是用于生成图像、音频、甚至3D分子结构的最先进预训练扩散模型的首选库。无论您是在寻找简单的推理解决方案，还是训练自己的扩散模型，Diffusers是一个两者都支持的模块化工具箱。Diffusers库设计重点在于易用性超过性能、简单超过便捷、可定制性超过抽象性。

## 版本约束

1. 暂不支持的官方版本或功能

   **更高版本**：暂不支持PyTorch2.3以上版本

2. diffusers软件版本配套关系

   | diffusers版本 | DCU适配版diffusers软件包版本       | DCU加速卡型号    | DTK版本 |
   | ------------- | ---------------------------------- | ---------------- | ------- |
   | 0.29.0        | 0.29.0+das.opt1.dtk24042           | 全系列           | 全系列  |

## 安装
组件支持
+ Python 3.8、3.9、3.10

### 1、使用pip方式安装
diffusers whl包下载目录：[https://cancon.hpccube.com:65024/4/main/diffusers](https://cancon.hpccube.com:65024/4/main/diffusers)，选择对应的python版本下载对应diffusers的whl包
```shell
pip install diffusers* (下载的diffusers的whl包)
```
### 2、使用源码编译方式安装

#### 源码编译安装
- 代码下载
```shell
git clone https://developer.hpccube.com/codes/OpenDAS/diffusers # 根据编译需要切换分支
```
- 提供2种源码编译方式（进入diffusers目录）：
```
1. 编译whl包并安装
python3 setup.py bdist_wheel
pip install dist/diffusers*

2. 源码编译安装
python3 setup.py install
```

## 验证
- python -c "import diffusers; print(diffusers.\_\_version__)"，版本号与官方版本同步，查询该软件的版本号，例如0.29.0；

## Known Issue
- 无

## 参考资料
- [README_ORIGIN](README_ORIGIN.md)
- [https://github.com/huggingface/diffusers](https://github.com/huggingface/diffusers)

## 建议阅读

有关diffusers的更多信息，请参见:

- [AI生态包](https://cancon.hpccube.com:65024/4/main/)
- [Model Zoo](https://sourcefind.cn/#/model-zoo/list)
- [DCU Toolkit](https://cancon.hpccube.com:65024/1/main)
- [驱动](https://cancon.hpccube.com:65024/6/main)
- [学习中心](https://developer.hpccube.com/study/)
- [论坛](https://forum.hpccube.com/)
- [diffusers huggingface](https://huggingface.co/docs/diffusers/index)
- [diffusers github](https://developer.hpccube.com/codes/OpenDAS/diffusers)
- [diffusers 使用示例](https://developer.hpccube.com/codes/modelzoo/hunyuandit_diffusers)
