이곡저곡 | Music Taste Lab

0. 준비물

• Docker, Docker Compose 설치
• 프로젝트 받기: git clone ...

1. 모델/데이터 받기

• 구글 드라이브에서 models_storage.zip을 내려받아 루트(프로젝트 최상단)에 풀어주세요.
  링크: https://drive.google.com/drive/folders/1yU78tk7153xfhntjr4SDHq8pRCQfF8Uq?usp=sharing

압축을 풀면 아래처럼 됩니다.

이곡저곡/
├── .env                # 스포티파이/오픈AI API KEY 설정
├── models_storage/     # zip 풀어서 생기는 폴더
│   ├── common/
│   │   ├── SASRec-Nov-28-2025_04-35-06.pth
│   │   ├── SASRec_faiss_index.bin
│   │   └── SASRec_playlist_track_mapping.pkl
│   └── sequences/
│       └── playlist_track_mapping.pkl
├── docker-compose.yml
├── Dockerfile
└── src/ ...

2. .env 작성

프로젝트 루트에 .env 파일 생성 후 채워 넣기:

SPOTIFY_CLIENT_ID=...
SPOTIFY_CLIENT_SECRET=...
OPENAI_API_KEY=...   # 선택 (없으면 LLM 멘트는 기본 문구로 대체)

3. 실행

루트 폴더에서:

docker compose up --build

완료 후 브라우저에서 http://localhost:8000 접속

4. 문제 발생 가능성

• 메모리 부족(OOM, exit 137): Docker Desktop 메모리 설정을 늘린 뒤 다시 실행.
• LLM 대기: .env에서 OPENAI_API_KEY를 비워두면 LLM을 건너뛰고 바로 응답합니다.

5. 중지/재시작

docker compose down      # 중지
docker compose up        # 재실행 (코드 변경 없으면 --build 생략 가능)

6. 로그 보기

docker compose logs -f