Construire une API Musicale qui Lit Dans les Pensées : Générateur de Playlists d'Humeur Alimenté par l'IA avec Node.js

Imaginez taper "Je viens de rompre et il pleut" et obtenir instantanément une playlist parfaitement organisée qui correspond exactement à ce que vous ressentez. Aujourd'hui, nous construisons une API qui lit les émotions humaines à partir de texte et génère des playlists Spotify personnalisées en utilisant l'analyse de sentiment par IA. Ce n'est pas juste un autre tutoriel. Nous créons quelque chose qui pourrait véritablement améliorer les journées des gens.

Ce Dont Vous Aurez Besoin

Node.js installé (nodejs.org)
Un compte développeur Spotify (gratuit sur developer.spotify.com)
Un éditeur de code - J'utiliserai VS Code mais vous pouvez utiliser votre propre éditeur de code si vous en avez un avec lequel vous êtes habitué, sinon vous pouvez télécharger VS Code ici : https://code.visualstudio.com/
Clé API OpenAI (ou nous utiliserons une bibliothèque gratuite d'analyse de sentiment)
Connaissance de base en JavaScript
Juste 30 minutes de votre temps

Télécharger et Installer Node.js

Allez sur nodejs.org

Cliquez sur Get Node.js

Faites défiler vers le bas de la page jusqu'à 'Or get a prebuilt Node.js'

L'installateur pré-compilé est la meilleure option surtout pour les débutants car :

C'est une configuration de 2 minutes au lieu de 30+ minutes de compilation
Il est garanti de fonctionner et a été testé par des millions
Vous pouvez commencer à coder plus rapidement

Sélectionnez votre système d'exploitation, Windows, macOs, Linux ou AIX

Et cliquez sur le bouton de téléchargement (aura Windows Installer (.msi), macOs (.pkg), Linux (.xz) ou Standalone Binary (.gz) comme texte du bouton)

Une fois téléchargé, ouvrez l'installateur et suivez ces étapes d'installation :

Étape 1 : Écran de Bienvenue

Double-cliquez sur le fichier d'installation téléchargé pour démarrer le processus d'installation. Vous verrez l'écran de bienvenue de configuration de Node.js.

Cliquez sur "Next" pour continuer.

Écran de bienvenue de l'installateur Node.js

Étape 2 : Accord de Licence

Lisez l'Accord de Licence (ou parcourez-le rapidement - c'est la licence standard open source).

Cochez la case "I accept the terms in the License Agreement".

Cliquez sur "Next" pour procéder.

Étape 3 : Choisir l'Emplacement d'Installation

Gardez le chemin d'installation par défaut (généralement C:\Program Files\nodejs\ sur Windows).

Ne changez rien à moins d'avoir une raison spécifique d'installer ailleurs.

Cliquez sur "Next" pour continuer.

Étape 4 : Sélectionner les Composants

Laissez toutes les cases cochées (Node.js runtime, npm package manager, online documentation shortcuts, et Add to PATH).

L'option "Add to PATH" est cruciale - cela vous permet d'exécuter Node.js depuis n'importe quelle invite de commande ou terminal.

Cliquez sur "Next" pour continuer.

Étape 5 : Outils pour Modules Natifs (CRITIQUE - Ne Pas Ignorer !)

⚠️ IMPORTANT : Vous DEVEZ cocher cette case !

Si vous ne cochez pas "Automatically install the necessary tools", votre Node.js ne fonctionnera pas correctement avec de nombreux packages. Cette étape est essentielle pour que le tutoriel fonctionne !

✅ Cochez la case "Automatically install the necessary tools".

Cela installe Python et Visual Studio Build Tools dont de nombreux packages npm ont besoin pour compiler le code natif correctement.

Cliquez sur "Next" pour continuer.

Outils supplémentaires Node.js - DOIT cocher la case

💡 Pourquoi cette case est cruciale :

De nombreux packages npm ont besoin de compiler du code natif et ne fonctionneront pas sans ces outils
Sans ces outils, vous obtiendrez des messages d'erreur cryptiques lors de l'installation de packages
Cela vous fait économiser des heures de dépannage plus tard dans votre parcours de développement

Étape 6 : Prêt à Installer

Examinez vos paramètres d'installation une dernière fois.

Cliquez sur "Install" pour commencer le processus d'installation.

Note : Vous pouvez voir une invite de Contrôle de Compte d'Utilisateur Windows - cliquez sur "Yes" pour autoriser l'installation.

Étape 7 : Installation Terminée

Attendez que l'installation se termine - cela prend généralement 1-2 minutes.

Cliquez sur "Finish" lorsque l'installation est terminée.

Étape 8 : Installer les Outils Supplémentaires (Si Vous Avez Coché la Case)

Si vous avez coché l'option "automatically install tools" à l'Étape 5, une fenêtre d'invite de commande apparaîtra comme ceci :

Terminal Node.js pour l'installation d'outils supplémentaires

👆 Appuyez sur n'importe quelle touche pour démarrer le processus d'installation

Ce qui se passe ensuite :

Appuyez sur N'IMPORTE QUELLE TOUCHE quand vous voyez l'invite pour commencer l'installation de Python et Visual Studio Build Tools
Attendez patiemment 10-15 minutes - cela installe les outils de développement dont de nombreux packages npm ont besoin
Vous verrez beaucoup de texte défiler - c'est normal ! Ne fermez pas la fenêtre
Appuyez sur ENTER lorsque l'installation est terminée pour quitter l'installateur

Cliquez sur n'importe quelle touche encore... vous obtiendrez probablement une autre popup vous demandant si vous voulez que l'application apporte des modifications à votre PC, allez-y et cliquez sur oui pour continuer l'installation. Vous devriez alors voir quelque chose comme ceci :

Installation des outils supplémentaires Node.js en cours

📦 Installation des Build Tools - Cela peut prendre 10-15 minutes

Attendez que l'installation se termine puis faites comme indiqué et tapez ENTER en bas du terminal et appuyez sur le bouton entrée de votre clavier pour quitter :

Installation Node.js terminée - appuyez sur ENTER pour quitter

Processus d'installation Node.js terminé

Configuration de Votre Environnement de Développement

Maintenant nous pouvons passer à la partie amusante et commencer à donner vie à notre application. Ouvrez d'abord votre éditeur de code. J'utiliserai VS Code et à moins que vous ne vous sentiez plus à l'aise avec un autre, je recommande d'utiliser VS Code, car il sera plus facile de suivre ce tutoriel.

Ouvrez votre terminal. Si vous ne savez pas comment faire cela, cliquez sur les 3 points en haut de votre éditeur de code et descendez jusqu'à 'Terminal', survolez-le puis cliquez sur 'New Terminal'.

Tapez les 4 commandes suivantes dans votre terminal, une à la fois :

mkdir mood-music-api
cd mood-music-api
npm init -y
npm install express axios sentiment dotenv spotify-web-api-node

Analyse des Commandes : Ce Que Chaque Étape Fait Réellement

1. mkdir mood-music-api

Ce que ça fait :

Crée un nouveau dossier vide appelé "mood-music-api"
mkdir = "make directory" (créer répertoire)

Pourquoi vous en avez besoin :

Votre projet a besoin de sa propre maison/espace de travail
Garde votre code organisé et séparé des autres projets
Comme créer un nouveau dossier pour chaque devoir scolaire

2. cd mood-music-api

Ce que ça fait :

Déplace votre terminal/invite de commande DANS ce dossier
cd = "change directory" (changer de répertoire)

Pourquoi vous en avez besoin :

Toutes les commandes futures s'exécuteront dans votre dossier de projet
Comme ouvrir un dossier spécifique avant de sauvegarder un document

3. npm init -y

Ce que ça fait :

Crée un fichier package.json avec les paramètres par défaut
package.json est comme la carte d'identité et la liste de courses de votre projet

Pourquoi vous en avez besoin :

Indique à Node.js que ce dossier EST un projet Node.js
Suit quelles bibliothèques (packages) votre projet nécessite
Stocke les informations du projet comme nom, version, description

4. npm install express axios sentiment dotenv spotify-web-api-node

Ce que ça fait :

Télécharge et installe 5 bibliothèques de code différentes dont votre projet a besoin
Crée un dossier node_modules avec des milliers de fichiers
Met à jour package.json pour se souvenir de ces dépendances

Ce que fait chaque bibliothèque :

express : Crée le serveur web qui gère les requêtes API
axios : Fait des requêtes HTTP vers d'autres APIs (comme Spotify)
sentiment : Analyse le texte pour détecter les émotions/humeur
dotenv : Stocke en sécurité les clés API secrètes
spotify-web-api-node : Se connecte à Spotify pour obtenir les données musicales

Maintenant ouvrez votre dossier en allant dans fichier puis ouvrir dossier et cherchez un dossier nommé mood-music-api et ouvrez-le.

Vous devriez maintenant voir un dossier nommé Mood-MUSIC-API dans votre explorateur avec node modules, un package-lock.json et un fichier package.json à l'intérieur.

Obtenir Vos Clés API Spotify (Étape par Étape)

Maintenant vous voulez créer un nouveau fichier et le nommer .env. Pour faire cela vous pouvez cliquer sur File puis New File et taper .env puis cliquer sur enter et taper le nom du fichier encore .env et cliquer sur Create File.

Avant de saisir quoi que ce soit dans ce fichier nous devons obtenir nos clés API.

Étape 1 : Créer un Compte Développeur Spotify

Allez sur : developer.spotify.com

Ce que vous verrez :

Un lien "Log in" en haut à droite
Si vous n'avez pas Spotify : Cliquez sur "Sign up" (c'est gratuit !)
Si vous avez Spotify : Utilisez votre compte existant

Important : Vous n'avez pas besoin de Spotify Premium - les comptes gratuits fonctionnent bien pour l'accès API !

Étape 2 : Créer Votre Application

Après vous être connecté :

Cliquez sur "Create app"

Remplissez le formulaire :

App name: Mood Music API
App description: AI-powered mood playlist generator
Website: http://localhost:3000 (pour l'instant)
Redirect URI: https://localhost:3000/callback

Quelles APIs prévoyez-vous d'utiliser ?

✅ Cochez "Web API"
✅ Cochez "Web Playback SDK" (optionnel, pour les fonctionnalités futures)

Acceptez les conditions et cliquez sur "Save"

Étape 3 : Obtenir Vos Clés Secrètes

Après avoir créé votre application :

Vous verrez le tableau de bord de votre application
Sous Basic Information vous verrez deux informations importantes :

Client ID: abc123def456... (visible, 32 caractères)
Client Secret: [Show client secret] (cliquez pour révéler)

Cliquez sur "Show client secret" pour révéler votre clé secrète
Copiez les deux clés - vous en aurez besoin dans l'étape suivante !

Ce que font ces clés :

Client ID : L'identifiant public de votre application (comme un nom d'utilisateur)
Client Secret : Le mot de passe de votre application (gardez-le privé !)

Étape 4 : Ajouter les Clés à Votre Projet

Ajoutez vos clés au fichier .env que vous avez créé :

SPOTIFY_CLIENT_ID=votre_client_id_réel_ici
SPOTIFY_CLIENT_SECRET=votre_client_secret_réel_ici
PORT=3000

Cliquez sur ctrl + s ou cmd + s ou File puis save pour sauvegarder vos modifications.

Étape 5 : Protéger Vos Secrets

Important : Ne partagez jamais votre Client Secret publiquement !

Ajoutez .env à votre fichier .gitignore en utilisant les commandes suivantes dans votre terminal :

# Créer le fichier .gitignore
# Ou sur macOS/Linux
touch .gitignore

# ou PowerShell
New-Item -Path ".gitignore" -ItemType "file"
# Ou encore plus simple : 
echo $null > .gitignore

# Ajouter cette ligne à .gitignore :
.env
node_modules/

Cliquez sur ctrl + s ou cmd + s ou File puis save pour sauvegarder vos modifications.

Le Moteur de Détection d'Humeur

Créez un fichier et nommez-le moodAnalyzer.js - c'est là que la magie opère.

Ajoutez le code suivant au fichier et sauvegardez vos modifications.

const Sentiment = require('sentiment');
const sentiment = new Sentiment();

class MoodAnalyzer {
  analyzeMood(text) {
    const result = sentiment.analyze(text);
    
    // Enhanced mood detection with context clues
    const moodKeywords = {
      energetic: ['pumped', 'excited', 'energy', 'workout', 'party', 'dancing'],
      sad: ['dumped', 'broke up', 'crying', 'lonely', 'depressed', 'heartbreak'],
      angry: ['furious', 'pissed', 'angry', 'mad', 'rage', 'frustrated'],
      chill: ['relax', 'calm', 'peaceful', 'meditation', 'study', 'focus'],
      romantic: ['love', 'date', 'crush', 'valentine', 'romantic', 'kiss'],
      nostalgic: ['memories', 'throwback', 'old days', 'reminiscing', 'vintage']
    };
    
    const lowerText = text.toLowerCase();
    let detectedMood = 'neutral';
    let confidence = Math.abs(result.score);
    
    // Check for specific mood keywords
    for (const [mood, keywords] of Object.entries(moodKeywords)) {
      if (keywords.some(keyword => lowerText.includes(keyword))) {
        detectedMood = mood;
        confidence += 2;
        break;
      }
    }
    
    // Fallback to sentiment score
    if (detectedMood === 'neutral') {
      if (result.score > 2) detectedMood = 'happy';
      else if (result.score < -2) detectedMood = 'sad';
      else if (result.score < 0) detectedMood = 'melancholy';
      else detectedMood = 'chill';
    }
    
    return {
      mood: detectedMood,
      confidence: Math.min(confidence, 10),
      sentiment: result.score,
      intensity: this.calculateIntensity(text, result.score)
    };
  }
  
  calculateIntensity(text, score) {
    const intensifiers = ['very', 'extremely', 'really', 'super', 'totally', '!!!', 'so much'];
    const hasIntensifiers = intensifiers.some(word => text.toLowerCase().includes(word));
    const baseIntensity = Math.abs(score) / 5;
    return Math.min((hasIntensifiers ? baseIntensity * 1.5 : baseIntensity), 1);
  }
}

module.exports = new MoodAnalyzer();

L'Assistant Générateur de Playlists Spotify

Créez un fichier et nommez-le playlistGenerator.js. Puis ajoutez le code suivant et sauvegardez vos modifications :

const SpotifyWebApi = require('spotify-web-api-node');

class PlaylistGenerator {
  constructor() {
    this.spotifyApi = new SpotifyWebApi({
      clientId: process.env.SPOTIFY_CLIENT_ID,
      clientSecret: process.env.SPOTIFY_CLIENT_SECRET
    });
    this.initializeSpotify();
  }
  
  async initializeSpotify() {
    try {
      console.log('🔑 Tentative d\'authentification Spotify...');
      console.log('Client ID:', process.env.SPOTIFY_CLIENT_ID ? 
        `${process.env.SPOTIFY_CLIENT_ID.substring(0, 8)}...` : 'MANQUANT');
      console.log('Client Secret:', process.env.SPOTIFY_CLIENT_SECRET ? 
        `${process.env.SPOTIFY_CLIENT_SECRET.substring(0, 8)}...` : 'MANQUANT');
      
      const data = await this.spotifyApi.clientCredentialsGrant();
      this.spotifyApi.setAccessToken(data.body['access_token']);
      console.log('🎵 Spotify connecté avec succès !');
    } catch (error) {
      console.error('❌ Échec de la connexion Spotify:', error.message);
      console.error('Code de statut:', error.statusCode);
      console.error('Cela signifie généralement des identifiants API invalides');
    }
  }
  
  // ... (reste du code comme montré dans votre document)
}

module.exports = PlaylistGenerator;

Le Serveur API Qui Lit Dans les Pensées

Créez un fichier et nommez-le server.js, ajoutez le code suivant et sauvegardez vos modifications :

require('dotenv').config();
const express = require('express');
const moodAnalyzer = require('./moodAnalyzer');
const PlaylistGenerator = require('./playlistGenerator');

// Add node-fetch for older Node.js versions
let fetch;
if (typeof globalThis.fetch === 'undefined') {
  console.log('📦 Node.js fetch non disponible, utilisation du package node-fetch...');
  try {
    fetch = require('node-fetch');
  } catch (error) {
    console.error('❌ Veuillez installer node-fetch: npm install node-fetch');
    process.exit(1);
  }
} else {
  fetch = globalThis.fetch;
  console.log('✅ Utilisation du fetch intégré de Node.js');
}

const app = express();
const PORT = process.env.PORT || 3000;
const playlistGen = new PlaylistGenerator();

app.use(express.json());

// Beautiful web interface
app.get('/', (req, res) => {
  res.send(`
    
    
    
        Mind-Reading Music API
        
    
    
        
            🧠🎵 Mind-Reading Music API
            Dites-moi comment vous vous sentez, et je créerai la playlist parfaite pour votre humeur !
            
            
            
            
            
                
            
        
        
        
    
    
  `);
});

// The magic endpoint
app.post('/api/mood-playlist', async (req, res) => {
  // API logic here
});

app.listen(PORT, () => {
  console.log(`🚀 Mind-Reading Music API en cours d'exécution sur http://localhost:${PORT}`);
  console.log('🧠 Prêt à analyser les humeurs et générer des playlists !');
});

Étape 5 : Testez Votre IA Émotionnelle

Démarrez votre serveur :

node server.js

Vous devriez voir quelque chose comme ceci :

Serveur en cours d'exécution dans le terminal

Maintenant ouvrez votre navigateur web et allez sur le lien local montré dans l'image ci-dessus (http://localhost:3000) pour tester votre Mind-Reading Music API !

Pièges Courants à Éviter

Limites de l'API Spotify : Le niveau gratuit a des limites de débit. Mettez en cache les réponses et implémentez une logique de nouvelle tentative pour une utilisation en production.
Mauvaise interprétation de l'humeur : Testez les cas limites comme le sarcasme ("génial, un autre lundi...") qui pourrait confondre l'analyse de sentiment.
Playlists vides : Gérez toujours les cas où Spotify ne renvoie aucune recommandation en fournissant des genres de secours.
Exposition des clés API : Ne jamais committer votre fichier .env. Utilisez des variables d'environnement en production.

Prochaines Étapes

Maintenant nous avons construit quelque chose de vraiment cool ! Voici comment le rendre encore meilleur :

Ajouter des comptes utilisateur : Stocker l'historique des humeurs et les préférences de playlist
Apprentissage automatique : Entraîner des modèles personnalisés sur les commentaires des utilisateurs pour améliorer la précision
Fonctionnalités sociales : Permettre aux utilisateurs de partager des playlists d'humeur avec des amis
Intégration vocale : Se connecter avec des APIs de synthèse vocale pour la détection d'humeur par la voix
Intégration d'objets connectés : Lire les données de fréquence cardiaque et d'activité pour des insights d'humeur plus profonds
Déployer et mettre à l'échelle : Utiliser Redis pour la mise en cache, implémenter une authentification appropriée

Votre Mind-Reading Music API peut maintenant comprendre les émotions humaines et répondre avec des bandes sonores parfaites. Cette combinaison d'analyse de sentiment par IA et de curation musicale représente l'avenir des expériences personnalisées. Les possibilités sont infinies !

Restez à l'affût de notre prochain tutoriel où nous développerons davantage cette application...