Kolors 설치 및 사용 가이드 (Mac)

1# conda 사용 시2conda create -n kolors python=3.103conda activate kolors4 5# venv 사용 시6python3 -m venv kolors-env7source kolors-env/bin/activate

1pip install torch torchvision torchaudio

1import torch2print(torch.backends.mps.is_available())   # True여야 함3print(torch.backends.mps.is_built())       # True여야 함

1pip install diffusers transformers accelerate sentencepiece

1pip install huggingface_hub2huggingface-cli download Kwai-Kolors/Kolors-diffusers --local-dir ./Kolors-diffusers

1import torch2 3# MPS 사용 가능 여부에 따라 디바이스 자동 선택4if torch.backends.mps.is_available():5    device = "mps"6    dtype = torch.float32   # MPS는 float16 지원이 불완전할 수 있음7elif torch.cuda.is_available():8    device = "cuda"9    dtype = torch.float1610else:11    device = "cpu"12    dtype = torch.float3213 14print(f"사용 디바이스: {device}")

1import torch2from diffusers import KolorsPipeline3 4pipe = KolorsPipeline.from_pretrained(5    "Kwai-Kolors/Kolors-diffusers",6    torch_dtype=torch.float32,   # MPS에서는 float32 권장7)8pipe = pipe.to("mps")9 10prompt = "A portrait of a young woman with soft lighting, photorealistic, 8k, high quality"11negative_prompt = "blurry, low quality, distorted, deformed"12 13image = pipe(14    prompt=prompt,15    negative_prompt=negative_prompt,16    guidance_scale=6.5,17    num_inference_steps=25,18    height=1024,19    width=1024,20).images[0]21 22image.save("output.png")23print("이미지가 output.png로 저장되었습니다.")

1import torch2from diffusers import KolorsPipeline, DPMSolverMultistepScheduler3 4pipe = KolorsPipeline.from_pretrained(5    "Kwai-Kolors/Kolors-diffusers",6    torch_dtype=torch.float32,7)8pipe.scheduler = DPMSolverMultistepScheduler.from_config(9    pipe.scheduler.config,10    use_karras_sigmas=True11)12pipe = pipe.to("mps")13 14image = pipe(15    prompt="a ladybug, macro photography, bokeh, high quality, cinematic",16    guidance_scale=6.5,17    num_inference_steps=25,18).images[0]19 20image.save("ladybug.png")

1# 중국어 프롬프트 예시 (사실적인 인물 사진)2prompt_zh = "一位年轻女性的肖像，柔和的自然光线，皮肤细腻，高质量，写实风格，8k"3 4# 영어 프롬프트 예시 (동일 의미)5prompt_en = "A portrait of a young woman, soft natural lighting, detailed skin texture, high quality, photorealistic, 8k"6 7# 중국어 이미지 내 텍스트 렌더링8prompt_text = '一只可爱的猫咪，拿着写着"你好"的牌子，高质量'

1# 보수적인 Mac 설정 예시 (메모리 절약)2image = pipe(3    prompt=prompt,4    negative_prompt=negative_prompt,5    guidance_scale=6.5,6    num_inference_steps=25,7    height=768,8    width=768,9    num_images_per_prompt=1,10).images[0]

1pipe.enable_attention_slicing()

1pipe.enable_vae_slicing()   # 메모리 절약2pipe.enable_vae_tiling()    # 고해상도 이미지 생성 시

1# 모델 일부를 CPU로 오프로드하여 메모리 사용량 절감2pipe.enable_model_cpu_offload()3# 참고: cpu_offload 사용 시 .to("mps") 호출 불필요

1import torch2from diffusers import KolorsPipeline3 4pipe = KolorsPipeline.from_pretrained(5    "Kwai-Kolors/Kolors-diffusers",6    torch_dtype=torch.float32,7)8 9# 메모리 최적화 옵션 적용10pipe.enable_attention_slicing()11pipe.enable_vae_slicing()12pipe.enable_model_cpu_offload()   # 이 옵션 사용 시 .to("mps") 생략13 14image = pipe(15    prompt="a beautiful sunset over the ocean, dramatic clouds, photorealistic",16    negative_prompt="blurry, low quality",17    guidance_scale=6.5,18    num_inference_steps=25,19    height=768,20    width=768,21).images[0]22 23image.save("sunset.png")

1# 환경 변수로 미지원 연산을 CPU로 폴백2import os3os.environ["PYTORCH_ENABLE_MPS_FALLBACK"] = "1"4 5# 또는 터미널에서 실행 전 설정6# export PYTORCH_ENABLE_MPS_FALLBACK=1

1# 1. 이미지 해상도 줄이기 (1024 → 768)2# 2. attention slicing 활성화3pipe.enable_attention_slicing(1)  # 가장 공격적인 슬라이싱4# 3. 다른 앱 종료 후 Python 재시작

1# sentencepiece 재설치2pip install --upgrade sentencepiece transformers

1# MPS에서 float16 사용 시 NaN이 발생할 수 있음2# float32로 변경3pipe = KolorsPipeline.from_pretrained(4    "Kwai-Kolors/Kolors-diffusers",5    torch_dtype=torch.float32,   # float16 → float326)