Repolode
apple-aiml-research

apple-aiml-research/ml-stable-diffusion

Stable Diffusion PyTorch 모델을 Core ML로 변환하고 Python 및 Swift 패키지를 통해 Apple Silicon 기기에서 이미지 생성을 실행합니다.

스타
17,968
포크
1,080
열린 이슈
192
마지막 커밋
지난달

어떤 프로젝트인가요?

ml-stable-diffusion은 Core ML을 사용해 Apple Silicon에서 Stable Diffusion을 실행하기 위한 Apple의 툴킷입니다. 두 부분으로 구성됩니다. Hugging Face의 PyTorch 체크포인트를 Core ML 모델 파일로 변환하고 diffusers 라이브러리로 이미지를 생성하는 Python 패키지와, macOS·iOS·iPadOS 앱에서 해당 Core ML 모델을 실행하도록 Xcode 프로젝트에 추가할 수 있는 Swift 패키지입니다.

변환 기능은 Stable Diffusion 1.x, 2.x, XL, 3 모델과 XL이 아닌 모델을 위한 ControlNet을 지원합니다. 또한 6비트까지의 palettization, 모델 크기를 더 줄이는 mixed-bit palettization, 최신 칩을 위한 activation quantization 등 가중치 압축 옵션도 제공합니다. 변환된 모델은 Hugging Face Hub에 공개되어 있습니다.

프로젝트에서 명시한 대상 요구 사항은 변환의 경우 macOS 13.1 이상, 런타임의 경우 iOS 16.2 이상이며, M1 세대 이상 Mac 및 iPad 하드웨어와 A14 이상 iPhone이 필요합니다. 공개된 벤치마크에는 여러 iPhone, iPad, Mac 모델이 포함됩니다.

핵심 기능

  • 01Stable Diffusion PyTorch 체크포인트를 Core ML .mlpackage 파일로 변환합니다.
  • 02Hugging Face diffusers 기반의 Python CLI와 파이프라인을 제공합니다.
  • 03Apple 앱에 이미지 생성을 통합할 수 있는 Swift 패키지를 제공합니다.
  • 04SD 1.x, 2.x, SDXL, SD 3 모델과 XL이 아닌 모델을 위한 ControlNet을 지원합니다.
  • 056비트 palettization부터 mixed-bit palettization까지 가중치 압축 옵션을 제공합니다.

활용 사례

  • 클라우드 GPU 없이 Mac이나 iPad에서 Stable Diffusion을 로컬로 실행합니다.
  • Swift로 만든 iOS 또는 macOS 앱에 기기 내 이미지 생성을 추가합니다.
  • 파인튜닝한 Stable Diffusion 체크포인트를 Apple 기기용 Core ML 모델로 변환합니다.
  • iPhone의 메모리 사용량을 줄이기 위해 모델 압축을 실험합니다.

사용 전 알아둘 점

  • Apple Silicon 하드웨어만 지원하며, M 시리즈 Mac 또는 iPad/iPhone 기기가 필요합니다.
  • 일부 메모리 개선 기능을 사용하려면 macOS 14 또는 iOS 17이 필요하며, 변환에는 Python 3.8과 coremltools 7.0이 고정 버전으로 사용됩니다.

토픽

자주 묻는 질문

ml-stable-diffusion은(는) 무엇인가요?
Stable Diffusion PyTorch 모델을 Core ML로 변환하고 Python 및 Swift 패키지를 통해 Apple Silicon 기기에서 이미지 생성을 실행합니다. ml-stable-diffusion은 Core ML을 사용해 Apple Silicon에서 Stable Diffusion을 실행하기 위한 Apple의 툴킷입니다. 두 부분으로 구성됩니다. Hugging Face의 PyTorch 체크포인트를 Core ML 모델 파일로 변환하고 diffusers 라이브러리로 이미지를 생성하는 Python 패키지와, macOS·iOS·iPadOS 앱에서 해당 Core ML 모델을 실행하도록 Xcode 프로젝트에 추가할 수 있는 Swift 패키지입니다.
ml-stable-diffusion은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ml-stable-diffusion은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ml-stable-diffusion은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. ml-stable-diffusion의 마지막 커밋은 2026년 9월 11일입니다.
ml-stable-diffusion은(는) 어디에 사용할 수 있나요?
클라우드 GPU 없이 Mac이나 iPad에서 Stable Diffusion을 로컬로 실행합니다. Swift로 만든 iOS 또는 macOS 앱에 기기 내 이미지 생성을 추가합니다. 파인튜닝한 Stable Diffusion 체크포인트를 Apple 기기용 Core ML 모델로 변환합니다. iPhone의 메모리 사용량을 줄이기 위해 모델 압축을 실험합니다.
ml-stable-diffusion은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/apple-aiml-research/ml-stable-diffusion

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트