Bygg et tankelesende musikk-API: AI-drevet spillelistegenerator for humør med Node.js

Se for deg at du skriver «Jeg ble nettopp dumpet, og det regner» og umiddelbart får en perfekt kuratert spilleliste som samsvarer nøyaktig med hvordan du føler deg. I dag bygger vi et API som leser menneskelige følelser fra tekst og genererer tilpassede Spotify-spillelister ved hjelp av AI-sentimentanalyse. Dette er ikke bare en annen veiledning. Vi lager noe som virkelig kan forbedre folks hverdag.

Dette trenger du

Node.js installert (nodejs.org)
En Spotify Developer-konto (gratis på developer.spotify.com)
En kodeeditor - jeg kommer til å bruke VS Code, men du kan bruke din egen kodeeditor hvis du har en du er vant til å bruke, ellers kan du laste ned VS Code her: https://code.visualstudio.com/
OpenAI API-nøkkel (eller vi bruker et gratis bibliotek for sentimentanalyse)
Grunnleggende JavaScript-kunnskaper
Bare 30 minutter av din tid

Last ned og installer Node.js

Gå til nodejs.org

Klikk på Hent Node.js

Bla nedover siden til 'Eller få en forhåndsbygd Node.js'

Det forhåndsbygde installasjonsprogrammet er det beste alternativet, spesielt for nybegynnere, siden:

Det er en 2-minutters oppsett i stedet for 30+ minutter kompilering
Det er garantert å fungere og har blitt testet av millioner av brukere.

Du kan begynne å kode raskere.

Velg operativsystemet ditt: Windows, MacOs, Linux eller AIX.

Og klikk på nedlastingsknappen (knappen vil inneholde Windows Installer (.msi), MacOs (.pkg), Linux (.xz) eller Standalone Binary (.gz) som tekst).

Når den er nedlastet, åpner du installasjonsprogrammet og følger disse trinnene:

Trinn 1: Velkomstskjerm.

Dobbeltklikk på den nedlastede installasjonsfilen for å starte installasjonsprosessen. Du vil se velkomstskjermen for Node.js-oppsettet.

Klikk på «Neste» for å fortsette.

Trinn 2: Lisensavtale

Les lisensavtalen (eller bare bla raskt gjennom den – det er standard åpen kildekode-lisens).

Merk av i boksen «Jeg godtar vilkårene i lisensavtalen».

Klikk på «Neste» for å fortsette.

Trinn 3: Velg Installasjon Plassering

Behold standard installasjonssti (vanligvis C:\Program Files\nodejs\ på Windows).

Ikke endre noe med mindre du har en spesifikk grunn til å installere et annet sted.

Klikk på "Neste" for å fortsette.

Trinn 4: Velg komponenter

La alle avmerkingsbokser være merket (Node.js runtime, npm pakkebehandler, snarveier til online dokumentasjon og Legg til i STI).

Alternativet "Legg til i STI" er avgjørende - dette lar deg kjøre Node.js fra hvilken som helst ledetekst eller terminal.

Klikk på "Neste" for å fortsette.

Trinn 5: Verktøy for native moduler (VIKTIG - Ikke hopp over!)

⚠️ VIKTIG: Du MÅ merke av i denne boksen!

Hvis du ikke merker av for "Installer de nødvendige verktøyene automatisk", vil ikke Node.js-en din fungere ordentlig med mange pakker. Dette trinnet er viktig for at veiledningen skal fungere!

✅ Merk av i boksen «Installer nødvendige verktøy automatisk».

Dette installerer Python og Visual Studio Build Tools som mange npm-pakker trenger for å kompilere native kode riktig.

Klikk på «Neste» for å fortsette.

💡 Hvorfor denne avmerkingsboksen er viktig:

Mange npm-pakker må kompilere native koder og vil ikke fungere uten disse verktøyene

Uten disse verktøyene vil du få kryptiske feilmeldinger når du installerer pakker

Dette sparer deg for timer med feilsøking senere i utviklingsprosessen

Trinn 6: Klar til installasjon

Gjennomgå installasjonsinnstillingene dine en siste gang.

Klikk på "Installer" for å starte installasjonsprosessen.

Merk: Du kan se en Windows-brukerkontokontroll-ledetekst – klikk på "Ja" for å tillate installasjonen.

Trinn 7: Installasjonen er fullført

Vent til installasjonen er fullført – dette tar vanligvis 1–2 minutter.

Klikk på «Fullfør» når installasjonen er fullført.

Trinn 8: Installer tilleggsverktøy (hvis du har krysset av i boksen)

Hvis du har krysset av for alternativet «installer verktøy automatisk» i trinn 5, vil et ledetekstvindu se slik ut:

👆 Trykk på en hvilken som helst tast for å starte installasjonsprosessen

Hva skjer videre:

Trykk på en hvilken som helst tast når du ser meldingen om å starte installasjonen av Python og Visual Studio Build Tools

Vent tålmodig i 10–15 minutter – dette installerer utviklingsverktøy som mange npm-pakker krever

Du vil se mye tekst som ruller – dette er normalt! Ikke lukk vinduet

Trykk ENTER når installasjonen er fullført for å avslutte installasjonsprogrammet

Klikk på en hvilken som helst tast igjen ... du vil sannsynligvis få en ny popup-vindu som spør deg om du vil at appen skal gjøre endringer på PC-en din. Klikk på ja for å fortsette med installasjonen. Du bør da se noe slikt:

📦 Installere byggeverktøy - Dette kan ta 10–15 minutter

Vent til installasjonen er ferdig, og gjør deretter som det står. Skriv ENTER nederst i terminalen og trykk på enter-knappen på tastaturet for å avslutte:

Oppsett av utviklingsmiljøet ditt

Nå kan vi komme til den morsomme delen og begynne å bringe appen vår til live. Først åpner du kodeditoren din. Jeg kommer til å bruke VS Code, og med mindre du føler deg mer komfortabel med å bruke en annen, anbefaler jeg å bruke VS Code, da det vil være enklere å følge denne veiledningen.

Åpne terminalen din. Hvis du ikke vet hvordan du gjør dette, klikk på de tre prikkene øverst i kodeeditoren og bla ned til «Terminal», hold musepekeren over den og klikk deretter på «Ny terminal».

Skriv inn følgende fire kommandoer i terminalen, én om gangen:

mkdir mood-music-api

cd mood-music-api

npm init -y

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

Kommandooversikt: Hva hvert trinn faktisk gjør

1. mkdir mood-music-api

Hva den gjør:

Oppretter en ny, tom mappe kalt "mood-music-api"

mkdir = "make directory"

Hvorfor du trenger dette:

Prosjektet ditt trenger sitt eget hjemme-/arbeidsområde

Holder koden din organisert og atskilt fra andre prosjekter

Som å opprette en ny mappe for hver skoleoppgave

2. cd mood-music-api

Hva den gjør:

Flytter terminal-/kommandoprompten din INN I den mappen

cd = "change directory"

Hvorfor du trenger dette:

Alle fremtidige kommandoer kjøres i prosjektmappen din

Som å åpne en bestemt mappe før du lagrer et dokument

3. npm init -y

Hva den gjør:

Oppretter en package.json-fil med standardinnstillinger

package.json er som prosjektets ID-kort og handleliste

Hvorfor du trenger dette:

Forteller Node.js at denne mappen ER et Node.js-prosjekt

Sporer hvilke biblioteker (pakker) prosjektet ditt trenger

Lagrer prosjektinformasjon som navn, versjon og beskrivelse

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

Hva den gjør:

Laster ned og installerer 5 forskjellige kodebiblioteker prosjektet ditt trenger

Oppretter en node_modules-mappe med tusenvis av filer

Oppdaterer package.json for å huske disse avhengighetene

Hva hvert bibliotek gjør:

express: Oppretter webserveren som håndterer API-forespørsler

axios: Sender HTTP-forespørsler til andre API-er (som Spotify)

sentiment: Analyserer tekst for å oppdage følelser/stemning

dotenv: Lagrer hemmelige API-nøkler trygt

spotify-web-api-node: Kobler til Spotify for å hente musikkdata

Åpne nå mappen din ved å gå til fil, deretter åpne mappen og søk etter en mappe som heter mood-music-api og åpne den.

Du skal nå se en mappe som heter Mood-MUSIC-API i utforskeren din med nodemoduler, en package-lock.json og en package.json-fil inni.

Hente Spotify API-nøklene dine (trinn for trinn)

Nå vil du opprette en ny fil og gi den navnet .env. For å gjøre dette kan du klikke på Fil, deretter Ny fil og skrive .env, deretter klikke på Enter og skrive inn filnavnet igjen .env og klikke på Opprett fil.

Før vi skriver inn noe i denne filen, må vi få tak i API-nøklene våre.

Trinn 1: Opprett en Spotify-utviklerkonto

Gå til: developer.spotify.com

Hva du ser:

En "Logg inn"-lenke øverst til høyre

Hvis du ikke har Spotify: Klikk på "Registrer deg" (det er gratis!)

Hvis du har Spotify: Bruk din eksisterende konto

Viktig: Du trenger ikke Spotify Premium – gratiskontoer fungerer fint for API-tilgang!

Trinn 2: Opprett appen din

Etter innlogging:

Klikk på "Opprett app"

Fyll ut skjemaet:

Appnavn: Mood Music API

Appbeskrivelse: AI-drevet spillelistegenerator for stemning

Nettsted: http://localhost:3000 (foreløpig)

Omdirigerings-URI: https://localhost:3000/callback

Hvilke API-er planlegger du å bruke?

✅ Merk av for "Web API"

✅ Merk av for "Web Playback SDK" (valgfritt, for fremtidige funksjoner)

Godta vilkårene og klikk på "Lagre"

Trinn 3: Skaff deg de hemmelige nøklene dine

Etter at du har opprettet appen din:

Du vil se appens dashbord

Under grunnleggende informasjon vil du se to viktige opplysninger:

Klient-ID: abc123def456... (synlig, 32 tegn)

Klienthemmelighet: [Vis klienthemmelighet] (klikk for å vise)

Klikk på "Vis klient secret" for å avsløre den hemmelige nøkkelen din

Kopier begge nøklene – du trenger dem i neste trinn!

Hva disse nøklene gjør:

Klient-ID: Appens offentlige identifikator (som et brukernavn)

Klienthemmelighet: Appens passord (hold dette privat!)

Trinn 4: Legg til nøkler i prosjektet ditt

Legg til nøklene dine i .env-filen du opprettet:

SPOTIFY_CLIENT_ID=your_actual_client_id_here SPOTIFY_CLIENT_SECRET=your_actual_client_secret_here PORT=3000

Klikk ctrl + s eller cmd + s eller Fil, og lagre deretter for å lagre endringer.

Trinn 5: Beskytt hemmelighetene dine

Viktig: Del aldri klienthemmeligheten din offentlig!

Legg til .env i .gitignore-filen din ved å bruke følgende kommandoer i terminalen din:

# Opprett .gitignore-fil # Eller på macOS/Linux, trykk på .gitignore # eller PowerShell New-Item -Path ".gitignore" -ItemType "file" # Eller enda enklere: echo $null > .gitignore # Legg til denne linjen i .gitignore: .env node_modules/

Klikk på ctrl + s eller cmd + s eller Fil, og lagre deretter for å lagre endringene.

Humørdeteksjonsmotoren

Opprett en fil og kall den moodAnalyzer.js – det er her magien skjer.

Legg til følgende kode til filen og lagre endringene dine.

const Sentiment = require('sentiment'); const sentiment = new Sentiment(); class MoodAnalyzer { analyzeMood(text) { const result = sentiment.analysere(text); // Forbedret humørdeteksjon med kontekstuelle ledetråder const moodKeywords = { energetic: ['pumped', 'excited', 'energy', 'workout', 'party', 'dancing'], sad: ['dumped', 'broke up', 'crying', 'lonely', 'deprimed', 'heartbreak'], angry: ['fious', 'pissed', 'angry', 'mad', 'raseri', 'frustrated'], chill: ['relax', 'cool', 'fredelig', 'meditasjon', 'study', 'focus'], romantic: ['love', 'date', 'crush', 'valentine', 'romantic', 'kiss'], nostalgic: ['memories', 'throwback', 'old days', 'reminiscing', 'vintage'] }; const lowerText = text.toLowerCase(); let detectedMood = 'nøytral'; la konfidens = Math.abs(resultat.score); // Se etter spesifikke nøkkelord for humør for (const [mood, nøkkelord] of Object.entries(moodKeywords)) { if (keywords.some(keyword => lowerText.includes(keyword))) { detectedMood = mood; confidence += 2; break; } } // Tilbakefall til sentimentscore if (detectedMood === 'nøytral') { if (result.score > 2) detectedMood = 'glad'; else if (result.score < -2) detectedMood = 'trist'; else if (result.score < 0) detectedMood = 'melankolsk'; else detectedMood = 'avslappet'; } return { mood: detectedMood, confidence: Math.min(confidence, 10), sentiment: result.score, intensity: this.calculateIntensity(text, result.score) }; } calculateIntensity(text, score) { const intensifiers = ['svært', 'ekstremt', 'virkelig', 'super', 'helt', '!!!', 'så mye']; 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();

Spotify-spillelisteveiviseren

Opprett en fil og gi den navnet playlistGenerator.js. Legg deretter til følgende kode og lagre endringene dine:

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('🔑 Forsøker Spotify-autentisering...'); console.log('Klient-ID:', process.env.SPOTIFY_CLIENT_ID ? `${process.env.SPOTIFY_CLIENT_ID.substring(0, 8)}...` : 'MANGLER'); console.log('Klienthemmelighet:', process.env.SPOTIFY_CLIENT_SECRET ? `${process.env.SPOTIFY_CLIENT_SECRET.substring(0, 8)}...` : 'MANGLER'); const data = await this.spotifyApi.clientCredentialsGrant(); this.spotifyApi.setAccessToken(data.body['access_token']); console.log('🎵 Spotify koblet til!'); } catch (error) { console.error('❌ Spotify-tilkobling mislyktes:', error.message); console.error('Statuskode:', error.statusCode); console.error('Dette betyr vanligvis ugyldig API-legitimasjon'); } } // ... (resten av koden som vist i dokumentet ditt) } module.exports = PlaylistGenerator;

Tankelesende API-server

Opprett en fil og gi den navnet server.js, legg til følgende kode og lagre endringene dine:

require('dotenv').config(); const express = require('express'); const moodAnalyzer = require('./moodAnalyzer'); const PlaylistGenerator = require('./playlistGenerator'); // Legg til node-fetch for eldre Node.js-versjoner let fetch; if (typeof globalThis.fetch === 'undefined') { console.log('📦 Node.js fetch er ikke tilgjengelig, bruker node-fetch-pakken...'); try { fetch = require('node-fetch'); } catch (error) { console.error('❌ Installer node-fetch: npm install node-fetch'); process.exit(1); } } else { fetch = globalThis.fetch; console.log('✅ Bruker innebygd Node.js fetch'); } const app = express(); const PORT = process.env.PORT || 3000; const playlistGen = new PlaylistGenerator(); app.use(express.json()); // Nydelig webgrensesnitt app.get('/', (req, res) => { res.send(\` <!DOCTYPE html> <html> <head> <title>Mind-Reading Music API</title> <style> /* Vakker gradientstyling og tilpassede lydkontroller */ </style> </head> <body> <div class="container"> <h1>🧠🎵 Mind-Reading Music API</h1> <p class="subtitle">Fortell meg hvordan du føler deg, så lager jeg den perfekte spillelisten for humøret ditt!</p> <textarea id="moodText" placeholder="Skriv hvordan du føler deg..."></textarea> <button onclick="generatePlaylist()">🎧 Generer spillelisten min</button> <div id="result" style="display:none;" class="result">  </div> </div> <script> // JavaScript for generering av spillelister og lydkontroller </script> </body> </html> \`); }); // Det magiske endepunktet app.post('/api/mood-playlist', async (req, res) => { // API-logikk her }); app.listen(PORT, () => { console.log(`🚀 Tankelesende musikk-API kjører på http://localhost:${PORT}`); console.log('🧠 Klar til å analysere stemninger og generere spillelister!'); });

Trinn 5: Test din emosjonelle AI

Start serveren din:

node server.js

Du bør se noe slikt:

Åpne nå nettleseren din og gå til den lokale lenken som vises på bildet ovenfor (http://localhost:3000) for å teste ditt Mind-Reading Music API!

Vanlige fallgruver å unngå

Spotify API-begrensninger: Gratisnivået har hastighetsbegrensninger. Bufre svar og implementer nytt forsøk-logikk for produksjonsbruk.

Misforståelse av stemning: Test kanttilfeller som sarkasme ("flott, nok en mandag...") som kan forvirre sentimentanalyse.

Tomme spillelister: Håndter alltid tilfeller der Spotify ikke returnerer noen anbefalinger ved å tilby alternative sjangre.

API-nøkkeleksponering: Lagre aldri .env-filen din. Bruk miljøvariabler i produksjon.

Neste trinn

Nå har vi bygget noe skikkelig kult! Slik gjør du det enda bedre:

Legg til brukerkontoer: Lagre humørhistorikk og spillelistepreferanser

Maskinlæring: Tren tilpassede modeller på brukertilbakemeldinger for å forbedre nøyaktigheten

Sosiale funksjoner: La brukere dele humørspillelister med venner

Stemmeintegrasjon: Koble til tale-til-tekst API-er for stemme-humørdeteksjon

Bærbar integrasjon: Les puls- og aktivitetsdata for dypere humørinnsikt

Distribuer og skaler: Bruk Redis for mellomlagring, implementer riktig autentisering

Ditt tankelesende musikk-API kan nå forstå menneskelige følelser og respondere med perfekte lydspor. Denne kombinasjonen av AI-sentimentanalyse og musikkkuratering representerer fremtiden for personlige opplevelser. Mulighetene er uendelige!
Følg med på vår neste veiledning der vi vil utvikle denne appen videre...