plex recommendation

Plex 추천

Plex가 최근에 본 영화를 RAG 기반 LLM 체인에 피드하여 시청 기록을 기반으로 추천을 받으세요.

Plex에 연결하기

두 가지가 필요합니다.

1. Plex가 실행되는 IP 주소
2. Plex 키 Plex 키는 설치 경로의 preferences.xml 파일에서 찾을 수 있습니다. 패키지 센터를 사용하여 Synology NAS에서 Plex를 실행하므로 /PlexMediaServer/AppData/Plex Media Server/Preferences.xml 에서 내 것을 찾았습니다.

PLEX_ADDRESS 및 PLEX_TOKEN 환경 변수에 이 두 가지를 모두 제공합니다.

데이터 마이그레이션

초기 부팅 시 시스템은 Plex 라이브러리가 벡터 데이터베이스에 저장되어 있는지 감지합니다. 그렇지 않은 경우 미디어가 검색됩니다. PLEX_DEFAULT_LIBRARY_SECTION 환경 변수를 통해 미디어를 다운로드하려면 기본 라이브러리를 제공해야 합니다. 이를 얻으려면 Plex에 직접 쿼리해야 하지만 제 영화는 섹션 3에 있습니다. 섹션을 제공하지 않으면 이 섹션으로 돌아갑니다.

LLM에 연결

이 추천 엔진은 Ollama에 연결됩니다. 직접 가져오거나 클라우드에서 실행할 수 있습니다. OLLAMA_ADDRESS , OLLAMA_EMBEDDING_MODEL 및 OLLAMA_LANGUAGE_MODEL 환경 변수로 제공하면 됩니다.

LLM 접지

backend/internal/pkg/langchain/generate.go 에서 RAG 프롬프트를 찾을 수 있습니다. 이것은 내 특정 요구에 따라 작성되었습니다. 귀하의 요구 사항이 내 요구 사항이 아닌 경우 그에 따라 접지 프롬프트를 조정하십시오. 매우 큰 미디어 컬렉션이 있는 경우 사용 중인 모델의 컨텍스트 창을 초과할 수 있습니다. backend/internal/pkg/plex/api.go 에서 미디어 게터에 전달된 제한을 조정하여 검색하는 타이틀의 양을 조정할 수 있습니다.

빌드 및 실행

소스에서 컴파일

이 저장소를 다운로드하고 go build -o recommendations .backend/cmd/main.go 사용하여 앱을 빌드하세요. 그러면 ./recommendations 로 실행할 수 있는 recommendations 이라는 바이너리가 빌드됩니다.

캐시된 응답

Postgres 데이터베이스는 ./pg-data 에 연결되어 있으며 권장 사항을 캐시하는 데 사용됩니다. 최근에 본 제목은 Base-64로 인코딩되어 LLM에서 제공하는 정규화된 권장 사항과 함께 저장됩니다. 이 캐시는 LLM 추천을 요청하기 전에 조회되며, 발견된 경우 그대로 반환됩니다.

기본 Postgres 환경

기본 Postgres 환경은 다음과 같습니다.

 POSTGRES_PASSWORD=postgres
POSTGRES_USER=postgres
POSTGRES_DB=caches
POSTGRES_PORT=5432
POSTGRES_HOST=postgres

이러한 환경 변수에 고유한 값을 제공하여 이를 재정의할 수 있습니다.

도커 작성

이 저장소의 루트에 docker-compose.yml 파일이 있습니다. TAG_VERSION=foo docker compose up --build 명령을 실행하여 추천 엔진 및 관련 Weaviate 데이터베이스를 실행할 수 있습니다. Docker와 Docker Compose가 설치되어 있는지 확인하세요.

이 앱 테스트하기

LLM이 거의 모두 작성한 내부 패키지에는 여러 가지 테스트가 있습니다. 이 저장소의 루트에서 go test ./... 사용하여 이 프로그램을 테스트할 수 있습니다. 이러한 테스트는 Docker로 빌드할 때 자동으로 실행됩니다.

개방형 원격 측정

Open Telemetry 추적은 백엔드에서 계측됩니다. 이를 즉시 사용하려면 환경에서 OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=otlp://jaeger:4317 설정하고 Jaeger 서비스가 Docker Compose에서 시작되는지 확인하세요. 추적은 Jaeger에서 수집되며 http://localhost:16686 에서 액세스할 수 있습니다. telemetry.WithMeter 옵션 telemetry.InitOtel() 을 전달하여 측정항목을 확장할 수 있습니다. 측정항목을 직접 계측해야 합니다.

원격 측정 비활성화

사용자 환경에서 DISABLE_TELEMETRY=true 설정하여 원격 측정을 비활성화할 수 있습니다. docker compose up 사용하는 경우 Jaeger 컨테이너는 계속 시작됩니다.