LOCAL_SETUP.md

맥북 로컬 개발 환경 설정

시스템 요구사항 ✅

• ✅ M1 Pro (확인됨)
• ✅ 32GB RAM (확인됨)
• ✅ macOS 환경

설치 방법

1. 가상환경 생성

python -m venv spacely_local
source spacely_local/bin/activate  # Mac/Linux

2. PyTorch 설치 (Apple Silicon 최적화)

pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu

3. 의존성 설치

pip install -r requirements_local.txt

4. 실행

python run_local.py

장점 🚀

• 속도: 허깅페이스 업로드 없이 즉시 테스트
• 디버깅: 실시간 콘솔 출력 확인
• 반복개발: 코드 수정 후 바로 확인
• GPU 가속: M1 Pro Metal Performance Shaders 활용

브라우저 접속

http://localhost:7860

개발 워크플로우

1. 코드 수정
2. 브라우저 새로고침
3. 즉시 테스트
4. 완성 후 허깅페이스 배포

문제 해결

• 메모리 부족 시: num_steps 줄이기
• 느린 로딩: 모델 캐싱 대기 (첫 실행만)
• 에러 발생: 콘솔에서 상세 로그 확인