Diffusers documentation
개요
시작하기
추론
확산 파이프라인 사용
어댑터 및 개인화
최적화 및 확장
모듈형 Diffusers
학습 및 파인튜닝
리소스
기여하기
API
You are viewing main version, which requires installation from source. If you'd like
regular pip install, checkout the latest stable version (v0.42.1).
개요
🤗 Diffusers는 자체 diffusion 모델을 학습할 수 있도록 다양한 학습 스크립트를 제공합니다. 모든 학습 스크립트는 diffusers/examples에서 찾을 수 있습니다.
각 학습 스크립트는 다음과 같습니다:
- 자기 완결형: 학습 스크립트는 로컬 파일에 의존하지 않으며, 스크립트 실행에 필요한 모든 패키지는
requirements.txt파일에서 설치됩니다. - 손쉽게 조정 가능: 학습 스크립트는 특정 작업을 위해 diffusion 모델을 학습하는 방법을 보여주는 예시이며, 모든 학습 시나리오에서 바로 사용할 수 없습니다. 사용자의 특정 사용 사례에 맞게 학습 스크립트를 수정해야 할 가능성이 높습니다. 이를 돕기 위해 데이터 전처리 코드와 학습 루프를 완전히 공개하여 사용자가 직접 수정할 수 있도록 했습니다.
- 입문자 친화적: 학습 스크립트는 최신 최첨단 기법을 포함하여 가장 경쟁력 있는 결과를 내는 것보다는, 입문자가 이해하기 쉽고 접근하기 쉽도록 설계되었습니다. 너무 복잡하다고 판단되는 학습 기법은 의도적으로 제외됩니다.
- 단일 목적: 각 학습 스크립트는 가독성과 이해도를 높이기 위해 오직 하나의 작업만을 수행하도록 명시적으로 설계되어 있습니다.
현재 제공되는 학습 스크립트 목록은 다음과 같습니다:
| 학습 | SDXL 지원 | LoRA 지원 |
|---|---|---|
| 무조건적 이미지 생성 | ||
| 텍스트-이미지 | 👍 | 👍 |
| 텍스추얼 인버전 | ||
| DreamBooth | 👍 | 👍 |
| ControlNet | 👍 | |
| InstructPix2Pix | 👍 | |
| 커스텀 디퓨전 | ||
| T2I-Adapters | 👍 | |
| Kandinsky 2.2 | 👍 |
이 예제들은 적극적으로 유지 관리되고 있으므로, 예상대로 작동하지 않는 경우 이슈를 열어 주시기 바랍니다. 다른 학습 예제가 포함되어야 한다고 생각하신다면, Feature Request를 시작하여 기능 아이디어를 논의하고, 독립적이며, 쉽게 수정할 수 있으며, 초보자에게 친화적이며, 단일 목적이라는 우리의 기준을 충족하는지 확인해 보시기 바랍니다.
설치
새 가상 환경에서 소스에서 라이브러리를 설치하여 최신 버전의 예제 스크립트를 성공적으로 실행할 수 있는지 확인하세요:
git clone https://github.com/huggingface/diffusers
cd diffusers
pip install .이후 학습 스크립트 폴더(예: DreamBooth)로 이동하여 requirements.txt 파일을 설치합니다. 일부 학습 스크립트는 SDXL 또는 LoRA를 위한 전용 요구 사항 파일을 제공합니다. 이러한 스크립트를 사용하는 경우, 해당 스크립트에 대응하는 요구 사항 파일을 설치했는지 확인하세요.
cd examples/dreambooth
pip install -r requirements.txt
# to train SDXL with DreamBooth
pip install -r requirements_sdxl.txt학습 속도를 높이고 메모리 사용량을 줄이기 위해 다음을 권장합니다:
- PyTorch 2.0 이상을 사용하여 학습 중에 scaled dot product attention을 자동으로 사용하도록 설정합니다(학습 코드를 수정할 필요가 없습니다).
- 메모리 효율적인 어텐션을 활성화하기 위해 xFormers 설치