playlist2vec

À PROPOS

Ce référentiel contient du code pour PlayList2Vec.com, un site Web conçu pour démontrer le modèle de recherche de vecteur décrit dans notre article, "Représentation, exploration et recommandation des listes de lecture".

CARACTÉRISTIQUES

• Interface de recherche intuitive et intégration Spotify
• Architecture des microservices pour une évolutivité transparente.
• Conteneurs Docker pour un déploiement rationalisé.
• Utilisation des bibliothèques à faible coût (recherche de vecteur SQLite et Usearch) pour minimiser l'empreinte de l'application.
• Recherche de vecteur basée sur MMAP permettant à l'application de fonctionner efficacement sur des machines à petit budget telles que Raspberry Pi.
• Configuration Nginx pour une gestion robuste du trafic.
• Limitation des taux mis en œuvre à la sauvegarde contre les attaques DDOS.
• Cache nginx pour optimiser l'utilisation des ressources du serveur.
• Capacités de mise à l'échelle automatique à l'aide de Kubernetes.

INSTALLATION

Remarque: Cette configuration a été testée sur Ubuntu 22.04 pour les architectures x86_64 et Aarch64.

1. Installer Docker

1. Suivez les instructions pour installer Docker à partir de ce lien: Installez Docker sur Ubuntu.
2. Assurez-vous de terminer les étapes post-installation décrites ici.

2. Installer Nginx

Installez Nginx en suivant le guide disponible sur: Comment installer Nginx sur Ubuntu 22.04.

3. Installer Nodejs

Vous pouvez installer Node.js (v20.18.0) en vous référant à ce tutoriel: comment installer Node.js sur Ubuntu 22.04.

4. Télécharger le code

Exécutez la commande suivante pour cloner le référentiel:

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

5. Accéder au projet

Accédez au répertoire du projet en fonctionnant:

 cd playlist2vec

6. Configuration Nginx

1. Copiez le fichier nginx/nginx.conf sur /etc/nginx/ .

2. Copiez le fichier nginx/site_config sur /etc/nginx/sites-available/<YOURSITENAME> .

3. Créez un lien symbolique des sites-available à sites-enabled avec la commande suivante:

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

4. Supprimez le fichier de configuration par défaut en exécutant:

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

5. Créez un répertoire de cache pour Nginx:

    sudo mkdir /var/cache/nginx
   

6. Vérifiez que la configuration est correcte en fonctionnant:

    sudo nginx -t
   

7. Redémarrez Nginx avec la commande:

    sudo systemctl restart nginx
   

7. Installez l'application

Depuis le répertoire du projet, exécutez le script de construction:

 ./build.sh.

Cela créera une version HTTP du site Web, qui peut être intégrée à un service comme un tunnel CloudFlare pour un frontend HTTPS.

Note

Par défaut, le script de construction configure l'application pour utiliser la mini version du corpus, qui contient 377 000 éléments. Dans cette configuration, l'index de recherche du mini corpus est chargé dans la mémoire. En revanche, l'index de recherche construit avec le corpus complet est accessible en mode mappé de mémoire.

Pour modifier ce paramètre, vous pouvez modifier le fichier .env . Définissez la variable IS_MINI sur false pour utiliser la version complète du corpus:

 IS_MINI=false

Exécuter en mode développement (sans nginx)

Configuration du service de recherche:

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

Configuration du service de saisie semi-automatique:

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

Configuration du serveur Web:

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

Exécuter des tests

 cd web-server
npm run test-dev

CITATION

 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