playlist2vec

UM

Dieses Repository enthält Code für Playlist2Vec.com, eine Website, die zum Demo des Vektorsuchmodells "Repräsentation, Exploration und Empfehlung von Wiedergabelisten" erstellt wurde.

MERKMALE

• Intuitive Suchschnittstelle und Spotify -Integration
• Microservices -Architektur für nahtlose Skalierbarkeit.
• Docker -Container für eine optimierte Bereitstellung.
• Nutzung kostengünstiger Bibliotheken (SQLite- und Usearch-Vektorsuche) zur Minimierung des App-Fußabdrucks.
• MMAP-basierte Vektorsuche ermöglicht es der Anwendung, budgetfreundliche Maschinen wie Raspberry Pi effizient zu betreiben.
• Nginx -Konfiguration für eine robuste Verkehrsbearbeitung.
• Die Ratenbegrenzung, die für den Schutz vor DDOS -Angriffen umgesetzt wird.
• Nginx Caching zur Optimierung der Serverressourcenverbrauch.
• Automatische Skalierungsfunktionen mit Kubernetes.

INSTALLATION

HINWEIS: Dieses Setup wurde auf Ubuntu 22.04 sowohl für x86_64 als auch für AARCH64 -Architekturen getestet.

1. Installieren Sie Docker

1. Befolgen Sie die Anweisungen, um Docker aus diesem Link zu installieren: Installieren Sie Docker auf Ubuntu.
2. Stellen Sie sicher, dass Sie die hier beschriebenen nach der Installationsschritte ausführen.

2. Installieren Sie Nginx

Installieren Sie Nginx, indem Sie die verfügbare Anleitung befolgen.

3. Installieren Sie NodeJs

Sie können node.js (v20.18.0) installieren, indem Sie sich auf dieses Tutorial beziehen: So installieren Sie node.js auf Ubuntu 22.04.

4. Code herunterladen

Führen Sie den folgenden Befehl aus, um das Repository zu klonen:

 git clone https://github.com/piyp791/playlist2vec.git

5. Navigieren Sie zum Projekt

Navigieren Sie zum Projektverzeichnis, indem Sie ausführen:

 cd playlist2vec

6. Nginx Setup

1. Kopieren Sie die Datei nginx/nginx.conf in /etc/nginx/ .

2. Kopieren Sie die Datei nginx/site_config in /etc/nginx/sites-available/<YOURSITENAME> .

3. Erstellen Sie einen symbolischen Link von sites-available zu sites-enabled :

    sudo ln -s /etc/nginx/sites-available/<YOURSITENAME> /etc/nginx/sites-enabled/
   

4. Entfernen Sie die Standardkonfigurationsdatei durch Ausführung:

    sudo rm /etc/nginx/sites-enabled/default
   

5. Erstellen Sie ein Cache -Verzeichnis für Nginx:

    sudo mkdir /var/cache/nginx
   

6. Überprüfen Sie, ob die Konfiguration durch Ausführen korrekt ist:

    sudo nginx -t
   

7. Starten Sie Nginx mit dem Befehl neu:

    sudo systemctl restart nginx
   

7. Installieren Sie die Anwendung

Führen Sie aus dem Projektverzeichnis das Build -Skript aus:

 ./build.sh.

Dadurch wird eine HTTP -Version der Website erstellt, die für einen HTTPS -Frontend in einen Dienst wie einen Cloudflare -Tunnel integriert werden kann.

Notiz

Standardmäßig konfiguriert das Build -Skript die Anwendung, um die Mini -Version des Korpus zu verwenden, die 377.000 Elemente enthält. In dieser Konfiguration wird der Suchindex für den Mini -Korpus in den Speicher geladen. Im Gegensatz dazu wird auf den mit vollständigen Corpus erstellten Suchindex im Speichermordmodus zugegriffen.

Um diese Einstellung zu ändern, können Sie die .env -Datei ändern. Setzen Sie die IS_MINI -Variable auf false um die Vollversion des Korpus zu verwenden:

 IS_MINI=false

Im Entwicklungsmodus ausführen (ohne Nginx)

Suchdienst einrichten:

 cd search-service
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn src.server:app --port 3001

Einrichten des automatischen Vervollständigungsdienstes:

 cd autocomplete-service
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn src.server:app --port 3002

Einrichten des Webservers:

 cd web-server
npm install
npm run start-dev-mode

Tests ausführen

 cd web-server
npm run test-dev

ZITAT

 Papreja, P., Venkateswara, H., Panchanathan, S. (2020). Representation, Exploration and Recommendation of Playlists. In: Cellier, P., Driessens, K. (eds) Machine Learning and Knowledge Discovery in Databases. ECML PKDD 2019. Communications in Computer and Information Science, vol 1168. Springer, Cham. https://doi.org/10.1007/978-3-030-43887-6_50