배포용 실행파일(exe) 빌드 방법

1. PyInstaller 설치 (최초 1회)

pip install pyinstaller

2. 빌드

저장소 루트에서:

python build_dist.py

빌드가 끝나면 dist/AtomPipelineGUI/ 폴더가 생긴다.

3. 팀 API 키 넣기 (수동 — 자동화하지 않음)

실제 팀 공용 API 키가 담긴 .env 파일을 직접 dist/AtomPipelineGUI/.env 로 복사한다 (.env.example을 참고해서 TRIPO_API_KEY=..., GEMINI_API_KEY=... 두 줄을 채운 파일).

이 키는 절대 저장소에 커밋하지 않는다.

4. 배포

dist/AtomPipelineGUI/ 폴더 전체를 zip으로 압축해서 기획자들에게 전달한다. 각자 압축을 풀고 AtomPipelineGUI.exe를 더블클릭하면 실행된다.

5. 각자 PC에 맞게 확인해야 할 것

unreal_config.yaml의 editor_cmd_path/uproject_path/bootstrap_script_path가 그 PC의 실제 설치 경로와 다르면 텍스트 에디터로 직접 수정해야 한다 (파일 위쪽 안내 주석 참고).

6. Unreal 임포트(3번 탭)를 쓰려면 추가로 필요한 것

atom_import/bootstrap/run_atom_import_template.py를 각자의 언리얼 프로젝트 Content/Python/run_atom_import.py 위치에 복사하고, 그 안의 REPO_ROOT 값을 압축 해제한 배포 폴더의 실제 경로로 수정해야 한다 (원래 개발 PC의 저장소 경로가 하드코딩돼 있어 그대로 두면 동작하지 않는다).

예: 배포 폴더를 C:\Tools\AtomPipelineGUI에 풀었다면, run_atom_import.py의 REPO_ROOT를 다음과 같이 수정:

REPO_ROOT = r"C:\Tools\AtomPipelineGUI"