AI Image Generator

Python 설치 없이 실행 가능한 AI 이미지 생성 프로그램

---

🚀 빠른 시작

Git 클론 (서브모듈 포함)

git clone --recurse-submodules https://github.com/ByeSub/Man-AI.git

이미 클론했다면:

git submodule update --init --recursive

참고: 대용량 모델 파일과 실행 결과물은 저장소에 포함되지 않습니다.

일반 사용 (Python 환경)

# 가상환경 활성화
.\.venv\Scripts\Activate.ps1

# 통합 런처 실행
python unified_launcher.py

EXE 파일로 빌드 (배포용)

# 빌드 메뉴 실행
.\EXE빌드_시작.bat

또는

# 직접 빌드
cd build
python build_exe_advanced.py

---

📁 프로젝트 구조

ManAI/
├── unified_launcher.py          # 통합 런처 (메인 실행 파일)
├── unified_launcher_fixed.py    # 수정된 런처
├── EXE빌드_시작.bat              # 빌드 시스템 시작
├── build/                       # 빌드 시스템
│   ├── 빌드_메뉴.bat             # 빌드 메뉴
│   ├── build_exe_advanced.py    # 고급 빌드 스크립트
│   ├── build_exe.py             # 기본 빌드 스크립트
│   ├── EXE_빌드_가이드.md        # 상세 가이드
│   └── 빠른_시작.md             # 빠른 시작 가이드
├── ai-image-generator/          # AI 이미지 생성기
│   ├── gui_launcher.py          # GUI 런처
│   ├── src/                     # 소스 코드
│   ├── models/                  # AI 모델
│   ├── lora_models/             # LoRA 모델
│   └── outputs/                 # 생성된 이미지
└── dist/                        # 빌드 결과물 (빌드 후 생성)
    └── AI_Image_Generator_Portable/

---

🎯 사용 방법

1. 개발 환경에서 실행

# Python 가상환경 활성화
.\.venv\Scripts\Activate.ps1

# 메인 런처 실행
python unified_launcher.py

2. EXE 파일로 빌드

간단한 방법:

EXE빌드_시작.bat 더블클릭

수동 빌드:

cd build
python build_exe_advanced.py

빌드 시간: 15-30분
필요 공간: 약 10GB

3. 빌드 결과물

dist\AI_Image_Generator_Portable\
├── AI_Image_Generator.exe    # 실행 파일
├── 실행.bat                  # 간편 실행
├── README.txt                # 사용 설명서
└── _internal\                # 모든 라이브러리 포함

이 폴더를 ZIP으로 압축하여 배포하면 Python 설치 없이 실행 가능합니다!

---

📋 기능

• ✅ 통합 런처 - 일반/NSFW 모드 선택
• ✅ LoRA 학습 - 커스텀 스타일 학습
• ✅ AnimateDiff - 애니메이션 생성
• ✅ GPU 가속 - NVIDIA GPU 지원
• ✅ 독립 실행 파일 - Python 설치 불필요
• ✅ 포터블 - USB나 클라우드로 이동 가능

---

🔧 시스템 요구사항

개발 환경

• Windows 10/11 (64bit)
• Python 3.8 이상
• NVIDIA GPU 권장 (선택사항)
• RAM: 8GB 이상 (16GB 권장)
• 디스크: 10GB 이상

실행 파일 (사용자 환경)

• Windows 10/11 (64bit)
• Python 설치 불필요!
• RAM: 8GB 이상
• GPU: NVIDIA GPU 권장 (선택사항)
• 디스크: 10GB 이상

---

📚 문서

• 빌드 가이드: build/EXE_빌드_가이드.md
• 빠른 시작: build/빠른_시작.md
• 사용 방법: build/사용방법.txt
• LoRA 학습: ai-image-generator/LORA_TRAINING_GUIDE.md
• GPU 최적화: ai-image-generator/gpu_optimization_guide.md

---

🎨 예제 사용법

이미지 생성

1. unified_launcher.py 실행
2. 모드 선택 (일반/NSFW)
3. 프롬프트 입력
4. 생성 버튼 클릭
5. ai-image-generator/outputs/ 폴더에 저장

LoRA 학습

1. 학습 이미지를 ai-image-generator/auto_images/ 폴더에 저장
2. LoRA 학습 모드 실행
3. 학습 설정
4. 학습 시작
5. 결과 모델이 lora_models/ 폴더에 저장

---

🚢 배포 방법

1. EXE 빌드

EXE빌드_시작.bat

2. 압축

Compress-Archive -Path "dist\AI_Image_Generator_Portable" -DestinationPath "AI_Image_Generator_v1.0.zip"

3. 배포

• USB 드라이브에 복사
• 클라우드 스토리지에 업로드
• 파일 공유 서비스 이용

4. 사용자 측 실행

1. ZIP 파일 다운로드
2. 압축 해제
3. AI_Image_Generator.exe 실행
4. Python 설치 불필요!

---

🔒 주의사항

• NSFW 콘텐츠: 법률 준수 필수
• 상업적 사용: 모델 라이선스 확인
• 저작권: 생성 이미지 사용 시 주의
• GPU 메모리: 해상도에 따라 조절

---

🆘 문제 해결

Python 환경 문제

# 가상환경 재생성
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r ai-image-generator/requirements.txt

빌드 실패

# PyInstaller 재설치
pip install --upgrade pyinstaller

# 수동 빌드
cd build
python build_exe_advanced.py

실행 파일 문제

• Windows Defender 예외 추가
• 관리자 권한으로 실행
• README.txt 참조

---

📞 지원

• 이슈: GitHub Issues
• 문서: build/ 폴더 내 가이드 참조
• 로그: 실행 시 생성되는 로그 파일 확인

---

📝 라이선스

이 프로젝트는 다양한 오픈소스 라이브러리를 사용합니다:

• Stable Diffusion: CreativeML Open RAIL-M
• PyTorch: BSD-style license
• Transformers: Apache 2.0
• 기타: 각 라이브러리의 라이선스 준수

생성된 이미지의 사용은 해당 모델의 라이선스를 따릅니다.

---

버전: 1.0
최종 업데이트: 2025-10-23
빌드 시스템: Portable Edition