Maua

Maua는 딥러닝을 사용하여 이미지, 비디오 및 오디오를 합성하기 위한 파이썬 라이브러리(및 커맨드 라인 인터페이스)입니다.

많은 연구 그룹들이 논문의 결과를 재현하기 위해 코드를 공개하지만, 환경을 올바르게 설정하고 자체 데이터로 알고리즘을 실행하는 방법을 알아내는 과정은 여전히 시간이 많이 소요되는 경우가 많습니다. Maua의 목표는 이러한 방법들을 한곳에 모아 창의적인 도구로 사용하기 쉽게 만드는 것입니다. 주요 설계 목표는 조합성(composability)입니다. 다양한 방법론들을 독특한 방식으로 결합함으로써 가능한 결과 공간과 창의적 자유도를 기하급수적으로 확장할 수 있습니다.

설치 (Installation)

딥러닝은 컴퓨팅 자원을 많이 소모하기 때문에, 적절한 GPU가 사실상 필수 요구 사항입니다. CUDA 설치를 진행한 후, Maua는 다음과 같이 uv를 사용하여 설치할 수 있습니다:

uv pip install git+https://github.com/maua-maua-maua/maua.git

git clone https://github.com/maua-maua-maua/maua.git
cd maua
uv pip install -e .

현재 설치는 Ubuntu 20.04 환경의 NVIDIA GPU에서만 테스트되었습니다. 다른 구성도 가능하지만 더 복잡할 수 있습니다. 문제가 발생하면 언제든지 이슈를 열어주세요!

사용법 (Usage)

커맨드 라인 (Command line)

사용 가능한 옵션을 확인하려면 --help를 사용하세요:

python -m maua --help
python -m maua autoregressive --help
python -m maua diffusion --help

클래시파이어 프리 가이디드 디퓨전(classifier-free guided diffusion)을 사용하여 이미지 생성:

python -m maua diffusion image --text "A street art mural of a dapper turtle with wings" --diffusion stable

이미지 세트를 사용하여 RuDALL-E를 파인튜닝하여 이미지 생성:

python -m maua autoregressive ru finetune --input_dir /path/to/directory/of/images/

RealESRGAN을 사용하여 이미지 업스케일링:

python -m maua super image upscale /path/to/image.png /path/to/image2.png /path/to/image3.png --model_name RealESRGAN-pbaylies-hr-paintings

파이썬 (Python)

모든 커맨드 라인 함수는 Python 내부에서도 가져와(import) 사용할 수 있습니다.

고해상도 확산 모델 (High resolution diffusion):

from maua.diffusion.image import image_sample
from maua.super.image import upscale

...

감사 인사 (Thanks)

자신의 작업을 커뮤니티에 공개해 준 모든 분들께 감사드립니다. Maua는 인터넷의 모든 오픈 소스 코드를 통합한 것이며, 이 놀라운 분들의 작업이 없었다면 불가능했을 것입니다. 아래는 Maua에 직접적 또는 간접적으로 기여한 코드의 사람들에 대한 (아마도 매우) 불완전한 목록입니다:

@crowsonkb, @ProGamerGov, @lucidrains, @dvschultz, @eps696, @l4rz, @caillonantoine, @ben-hayes, @adrienchaton, @sportsracer48, @afiaka87, @aydao, @rosinality, @genekogan, @dribnet, @alexjc, @htoyryla, @neverix, @sniklaus, @xinntao, @cszn, @JingyunLiang, @kentsyx, @kakaobrain, @yu45020, @twitter@advadnoun, @twitter@danielrussruss, @twitter@ai_curio

인용 (Citations)

Maua는 연구 커뮤니티에서 직접 나온 많은 혁신에 의존합니다. 따라서 Maua를 어떤 방식으로든 연구 관련 목적으로 사용한다면 일부 논문을 인용해야 한다고 말할 수 있습니다. 관련된 논문을 찾아 인용해 주시기를 최선을 다해 부탁드립니다!

라이선스 (License)

이 저장소의 주요 라이선스는 GPL-v3입니다. 하지만 코드 출처가 매우 다양하기 때문에, 각 구성 요소는 다른 라이선스를 따를 수 있습니다. Maua 라이브러리의 모든 부분이 올바르게 라이선싱되고 속성이 부여되도록 하는 작업이 계속 진행 중입니다. 라이선스와 관련하여 문제가 있다면 이슈(issue)를 제기해 주시면 최대한 빨리 수정될 것입니다!

이 코드는 사람들이 예술을 만들고 딥러닝 합성(deep learning synthesis)을 탐구할 수 있도록 무료로 제공됩니다. 앞서 언급된 라이선스 때문에 Maua의 상업적 사용은 까다로울 수 있습니다. 모든 서브모듈의 라이선스 조건을 준수하고 있는지 확인해야 합니다!

일반적으로 출력물은 코드의 라이선스를 따르지 않습니다. 모델 가중치와 모델 출력물의 저작권은 여전히 큰 회색 영역이므로, 상업적으로 사용할 경우 본인의 책임 하에 사용하십시오! 일반적인 지침으로, 자신이 만들고 있는 것이 정말로 변형적(transformative)인지 고려해 보십시오. 만약 단순히 누군가의 소셜 미디어 페이지를 긁어와 그 사람을 모방하도록 모델을 학습시켰다면, 해당 개인에게 크레딧을 제공해야 하며, 그들과 논의하지 않고는 모델이나 출력물을 상업적으로 사용해서는 안 됩니다.