mirror of
https://github.com/huggingface/diffusers.git
synced 2026-01-29 07:22:12 +03:00
4aa68291a9
* add translated docs * improve translated content * improve translated content * Modify the translation content
147 lines
4.4 KiB
Plaintext
147 lines
4.4 KiB
Plaintext
<!--Copyright 2023 The HuggingFace Team. All rights reserved.
|
||
|
||
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
|
||
the License. You may obtain a copy of the License at
|
||
|
||
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
||
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
|
||
an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
|
||
specific language governing permissions and limitations under the License.
|
||
-->
|
||
|
||
# 安装
|
||
|
||
安装🤗 Diffusers 到你正在使用的任何深度学习框架中。
|
||
|
||
🤗 Diffusers已在Python 3.7+、PyTorch 1.7.0+和Flax上进行了测试。按照下面的安装说明，针对你正在使用的深度学习框架进行安装：
|
||
|
||
- [PyTorch](https://pytorch.org/get-started/locally/) installation instructions.
|
||
- [Flax](https://flax.readthedocs.io/en/latest/) installation instructions.
|
||
|
||
## 使用pip安装
|
||
|
||
你需要在[虚拟环境](https://docs.python.org/3/library/venv.html)中安装🤗 Diffusers 。
|
||
|
||
如果你对 Python 虚拟环境不熟悉，可以看看这个[教程](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/).
|
||
|
||
使用虚拟环境你可以轻松管理不同的项目，避免了依赖项之间的兼容性问题。
|
||
|
||
首先，在你的项目目录下创建一个虚拟环境：
|
||
|
||
```bash
|
||
python -m venv .env
|
||
```
|
||
|
||
激活虚拟环境：
|
||
|
||
```bash
|
||
source .env/bin/activate
|
||
```
|
||
|
||
现在你就可以安装 🤗 Diffusers了！使用下边这个命令：
|
||
|
||
**PyTorch**
|
||
|
||
```bash
|
||
pip install diffusers["torch"]
|
||
```
|
||
|
||
**Flax**
|
||
|
||
```bash
|
||
pip install diffusers["flax"]
|
||
```
|
||
|
||
## 从源代码安装
|
||
|
||
在从源代码安装 `diffusers` 之前，你先确定你已经安装了 `torch` 和 `accelerate`。
|
||
|
||
`torch`的安装教程可以看 `torch` [文档](https://pytorch.org/get-started/locally/#start-locally).
|
||
|
||
安装 `accelerate`
|
||
|
||
```bash
|
||
pip install accelerate
|
||
```
|
||
|
||
从源码安装 🤗 Diffusers 使用以下命令:
|
||
|
||
```bash
|
||
pip install git+https://github.com/huggingface/diffusers
|
||
```
|
||
|
||
这个命令安装的是最新的 `main`版本，而不是最近的`stable`版。
|
||
`main`是一直和最新进展保持一致的。比如，上次正式版发布了，有bug，新的正式版还没推出，但是`main`中可以看到这个bug被修复了。
|
||
但是这也意味着 `main`版本并不总是稳定的。
|
||
|
||
我们努力保持`main`版本正常运行,大多数问题都能在几个小时或一天之内解决
|
||
|
||
如果你遇到了问题，可以提 [Issue](https://github.com/huggingface/transformers/issues)，这样我们就能更快修复问题了。
|
||
|
||
## 可修改安装
|
||
|
||
如果你想做以下两件事，那你可能需要一个可修改代码的安装方式：
|
||
|
||
* 使用 `main`版本的源代码。
|
||
* 为 🤗 Diffusers 贡献，需要测试代码中的变化。
|
||
|
||
使用以下命令克隆并安装 🤗 Diffusers:
|
||
|
||
```bash
|
||
git clone https://github.com/huggingface/diffusers.git
|
||
cd diffusers
|
||
```
|
||
|
||
**PyTorch**
|
||
|
||
```
|
||
pip install -e ".[torch]"
|
||
```
|
||
|
||
**Flax**
|
||
|
||
```
|
||
pip install -e ".[flax]"
|
||
```
|
||
|
||
这些命令将连接你克隆的版本库和你的 Python 库路径。
|
||
现在，除了正常的库路径外，Python 还会在你克隆的文件夹内寻找。
|
||
例如，如果你的 Python 包通常安装在 `~/anaconda3/envs/main/lib/python3.7/Site-packages/`，Python 也会搜索你克隆到的文件夹。`~/diffusers/`。
|
||
|
||
<Tip warning={true}>
|
||
|
||
如果你想继续使用这个库，你必须保留 `diffusers` 文件夹。
|
||
|
||
</Tip>
|
||
|
||
|
||
现在你可以用下面的命令轻松地将你克隆的🤗Diffusers仓库更新到最新版本。
|
||
|
||
```bash
|
||
cd ~/diffusers/
|
||
git pull
|
||
```
|
||
|
||
你的Python环境将在下次运行时找到`main`版本的🤗 Diffusers。
|
||
|
||
## 注意遥测日志
|
||
|
||
我们的库会在使用`from_pretrained()`请求期间收集信息。这些数据包括Diffusers和PyTorch/Flax的版本，请求的模型或管道，以及预训练检查点的路径（如果它被托管在Hub上）。
|
||
|
||
这些使用数据有助于我们调试问题并优先考虑新功能。
|
||
当从HuggingFace Hub加载模型和管道时才会发送遥测数据，并且在本地使用时不会收集数据。
|
||
|
||
我们知道并不是每个人都想分享这些的信息，我们尊重您的隐私，
|
||
因此您可以通过在终端中设置“DISABLE_TELEMETRY”环境变量来禁用遥测数据的收集：
|
||
|
||
|
||
在Linux/MacOS中:
|
||
```bash
|
||
export DISABLE_TELEMETRY=YES
|
||
```
|
||
|
||
在Windows中:
|
||
```bash
|
||
set DISABLE_TELEMETRY=YES
|
||
``` |