Personal Music Knowledge Base: 개인 음악 지식 베이스 분석 시스템

본 프로그램은 사용자가 직접 음악 데이터를 입력하고 관리하며, AI를 통해 취향 분석 및 음악 추천을 받을 수 있는 개인 맞춤형 음악 데이터베이스 시스템이다.

사용자는 음악 제목, 아티스트, 국가, 태그, 메모 등의 정보를 입력하여 데이터를 저장할 수 있으며, 저장된 데이터는 사용자 닉네임 기준으로 CSV 파일 형태로 관리된다.

또한 LLM API를 활용하여

• 음악 태그 자동 추천

• 사용자 취향 분석 (자연어 설명)

• 맞춤형 음악 추천

기능을 제공한다.

본 시스템은 FastAPI 기반 API 서버와 Streamlit 기반 UI로 구성되어 있으며, Pandas를 활용한 데이터 처리 및 CSV 기반 저장 구조를 사용한다.

특히 입력값 검증, 데이터 부족 조건 제한, API 예외 처리 등을 통해 다양한 상황에서도 안정적으로 동작하도록 구현하였다.

로컬 환경의 실행 방법은 다음과 같다.

1. FastAPI 서버 실행 (uvicorn api.main:app --reload)

2. Streamlit 실행 (streamlit run app/main.py)

3. 웹 UI 접속 후 기능 사용