मन पढ़ने वाली संगीत API बनाएं: Node.js के साथ AI-संचालित मूड प्लेलिस्ट जेनरेटर

कल्पना करें कि आप "मैंने अभी-अभी ब्रेकअप किया है और बारिश हो रही है" टाइप करते हैं और तुरंत एक पूरी तरह से व्यक्तिगत प्लेलिस्ट मिलती है जो आपकी भावनाओं से बिल्कुल मैच करती है। आज, हम एक API बना रहे हैं जो टेक्स्ट से मानवीय भावनाओं को पढ़ती है और AI भावना विश्लेषण का उपयोग करके कस्टम Spotify प्लेलिस्ट बनाती है। यह केवल एक और ट्यूटोरियल नहीं है। हम कुछ ऐसा बना रहे हैं जो वास्तव में लोगों के दिन को बेहतर बना सकता है।

आपको क्या चाहिए

Node.js इंस्टॉल किया हुआ (nodejs.org)
एक Spotify डेवलपर अकाउंट (developer.spotify.com पर मुफ्त)
एक कोड एडिटर - मैं VS Code का उपयोग करूंगा लेकिन आप अपना कोड एडिटर उपयोग कर सकते हैं यदि आपका कोई है जिसका आप उपयोग करने के आदी हैं अन्यथा आप यहां VS Code डाउनलोड कर सकते हैं: https://code.visualstudio.com/
OpenAI API की (या हम एक मुफ्त भावना विश्लेषण लाइब्रेरी का उपयोग करेंगे)
JavaScript का बुनियादी ज्ञान
सिर्फ आपके 30 मिनट का समय

Node.js डाउनलोड और इंस्टॉल करें

nodejs.org पर जाएं

Get Node.js पर क्लिक करें

पेज को नीचे स्क्रॉल करें 'Or get a prebuilt Node.js' तक

प्रीबिल्ट इंस्टॉलर सबसे अच्छा विकल्प है विशेष रूप से शुरुआती लोगों के लिए क्योंकि:

यह 2-मिनट का सेटअप है 30+ मिनट की कंपाइलिंग के बजाय
यह काम करने की गारंटी है और लाखों द्वारा परीक्षित है
आप तेज़ी से कोडिंग शुरू कर सकते हैं

अपना ऑपरेटिंग सिस्टम चुनें, Windows, macOs, Linux या AIX

और डाउनलोड बटन पर क्लिक करें (बटन टेक्स्ट Windows Installer (.msi), macOs (.pkg), Linux (.xz) या Standalone Binary (.gz) होगा)

डाउनलोड के बाद, इंस्टॉलर खोलें और इन इंस्टॉलेशन चरणों का पालन करें:

चरण 1: स्वागत स्क्रीन

डाउनलोड की गई इंस्टॉलर फ़ाइल पर डबल-क्लिक करें इंस्टॉलेशन प्रक्रिया शुरू करने के लिए। आपको Node.js Setup Welcome स्क्रीन दिखेगी।

"Next" पर क्लिक करें जारी रखने के लिए।

चरण 2: लाइसेंस समझौता

लाइसेंस समझौता पढ़ें (या बस इसे तेज़ी से स्क्रॉल करें - यह मानक ओपन सोर्स लाइसेंस है)।

"I accept the terms in the License Agreement" चेकबॉक्स चेक करें।

"Next" पर क्लिक करें आगे बढ़ने के लिए।

चरण 3: इंस्टॉलेशन स्थान चुनें

डिफ़ॉल्ट इंस्टॉलेशन पथ रखें (आमतौर पर Windows पर C:\Program Files\nodejs\)।

कुछ भी न बदलें जब तक कि आपके पास कहीं और इंस्टॉल करने का विशेष कारण न हो।

"Next" पर क्लिक करें जारी रखने के लिए।

चरण 4: घटकों का चयन करें

सभी चेकबॉक्स चुने गए छोड़ दें (Node.js runtime, npm package manager, online documentation shortcuts, और Add to PATH)।

"Add to PATH" विकल्प महत्वपूर्ण है - यह आपको किसी भी command prompt या terminal से Node.js चलाने देता है।

"Next" पर क्लिक करें जारी रखने के लिए।

चरण 5: नेटिव मॉड्यूल के लिए टूल्स (महत्वपूर्ण - स्किप न करें!)

⚠️ महत्वपूर्ण: आपको इस बॉक्स को चेक करना होगा!

यदि आप "Automatically install the necessary tools" को चेक नहीं करते हैं, तो आपका Node.js कई पैकेज के साथ ठीक से काम नहीं करेगा। यह चरण ट्यूटोरियल के काम करने के लिए आवश्यक है!

✅ "Automatically install the necessary tools" चेकबॉक्स चेक करें।

यह Python और Visual Studio Build Tools इंस्टॉल करता है जो कई npm पैकेज को नेटिव कोड को ठीक से compile करने के लिए चाहिए।

"Next" पर क्लिक करें जारी रखने के लिए।

Node.js अतिरिक्त टूल्स - चेकबॉक्स चेक करना आवश्यक

💡 यह चेकबॉक्स क्यों महत्वपूर्ण है:

कई npm पैकेज को नेटिव कोड compile करने की ज़रूरत होती है और ये टूल्स के बिना काम नहीं करेंगे
इन टूल्स के बिना, आपको पैकेज इंस्टॉल करते समय रहस्यमय एरर मैसेज मिलेंगे
यह आपके डेवलपमेंट जर्नी में बाद में घंटों की troubleshooting बचाता है

चरण 6: इंस्टॉल करने के लिए तैयार

अपनी इंस्टॉलेशन सेटिंग्स की अंतिम बार समीक्षा करें।

"Install" पर क्लिक करें इंस्टॉलेशन प्रक्रिया शुरू करने के लिए।

नोट: आपको Windows User Account Control prompt दिख सकता है - इंस्टॉलेशन को अनुमति देने के लिए "Yes" पर क्लिक करें।

चरण 7: इंस्टॉलेशन पूरा

इंस्टॉलेशन पूरा होने की प्रतीक्षा करें - आमतौर पर 1-2 मिनट लगते हैं।

इंस्टॉलेशन पूरा होने पर "Finish" पर क्लिक करें।

चरण 8: अतिरिक्त टूल्स इंस्टॉल करें (यदि आपने चरण 5 में बॉक्स चेक किया था)

यदि आपने चरण 5 में "automatically install tools" विकल्प चेक किया था, तो इस तरह की command prompt विंडो दिखेगी:

अतिरिक्त टूल्स इंस्टॉलेशन के लिए Node.js टर्मिनल

👆 इंस्टॉलेशन प्रक्रिया शुरू करने के लिए कोई भी key दबाएं

आगे क्या होता है:

जब प्रॉम्प्ट दिखे तो कोई भी KEY दबाएं Python और Visual Studio Build Tools इंस्टॉल करना शुरू करने के लिए
10-15 मिनट धैर्यपूर्वक प्रतीक्षा करें - यह development टूल्स इंस्टॉल करता है जिनकी कई npm पैकेज को ज़रूरत होती है
आपको बहुत सारा टेक्स्ट स्क्रॉल होता दिखेगा - यह सामान्य है! विंडो को बंद न करें
इंस्टॉलेशन पूरा होने पर ENTER दबाएं इंस्टॉलर से बाहर निकलने के लिए

फिर से कोई भी key पर क्लिक करें...आपको शायद एक और popup मिलेगा जो पूछेगा कि क्या आप चाहते हैं कि ऐप आपके PC में बदलाव करे, आगे बढ़ें और इंस्टॉल के साथ आगे बढ़ने के लिए हां पर क्लिक करें। आपको फिर कुछ इस तरह दिखना चाहिए:

Node.js अतिरिक्त टूल्स इंस्टॉलेशन प्रगति में

📦 बिल्ड टूल्स इंस्टॉल कर रहे हैं - इसमें 10-15 मिनट लग सकते हैं

इंस्टॉल होने का इंतज़ार करें और फिर जैसा कहा गया है वैसा करें और टर्मिनल के नीचे ENTER टाइप करें और exit करने के लिए अपने keyboard पर enter बटन दबाएं:

Node.js इंस्टॉलेशन पूरा - exit करने के लिए ENTER दबाएं

अपना डेवलपमेंट एनवायरनमेंट सेट करना

अब हम मज़ेदार हिस्से पर आ सकते हैं और अपने ऐप को जीवंत बनाना शुरू कर सकते हैं। सबसे पहले अपना कोड एडिटर खोलें। मैं VS Code का उपयोग करूंगा और जब तक आप किसी दूसरे के साथ अधिक सहज महसूस न करें, मैं VS Code का उपयोग करने की सलाह देता हूं, क्योंकि इस ट्यूटोरियल का पालन करना आसान होगा।

अपना टर्मिनल खोलें। यदि आप नहीं जानते कि यह कैसे करना है, तो अपने कोड एडिटर के टॉप पर 3 डॉट्स पर क्लिक करें और 'Terminal' तक नीचे स्क्रॉल करें, उस पर hover करें और फिर 'New Terminal' पर क्लिक करें।

अपने टर्मिनल में निम्नलिखित 4 commands टाइप करें, एक समय में एक:

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

कमांड विवरण: हर चरण वास्तव में क्या करता है

1. mkdir mood-music-api

यह क्या करता है:

"mood-music-api" नाम का एक नया खाली फ़ोल्डर बनाता है
mkdir = "make directory" (डायरेक्टरी बनाएं)

आपको इसकी आवश्यकता क्यों है:

आपके प्रोजेक्ट को अपना घर/workspace चाहिए
आपके कोड को organized रखता है और अन्य प्रोजेक्ट्स से अलग करता है
हर स्कूल असाइनमेंट के लिए नया फ़ोल्डर बनाने जैसा

2. cd mood-music-api

यह क्या करता है:

आपके टर्मिनल/command prompt को उस फ़ोल्डर के अंदर ले जाता है
cd = "change directory" (डायरेक्टरी बदलें)

आपको इसकी आवश्यकता क्यों है:

सभी भविष्य की commands आपके प्रोजेक्ट फ़ोल्डर के अंदर चलेंगी
document save करने से पहले specific फ़ोल्डर खोलने जैसा

3. npm init -y

यह क्या करता है:

default settings के साथ package.json फ़ाइल बनाता है
package.json आपके प्रोजेक्ट का ID card और shopping list की तरह है

आपको इसकी आवश्यकता क्यों है:

Node.js को बताता है कि यह फ़ोल्डर एक Node.js प्रोजेक्ट है
track करता है कि आपके प्रोजेक्ट को कौन सी libraries (packages) चाहिए
प्रोजेक्ट की जानकारी store करता है जैसे name, version, description

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

यह क्या करता है:

आपके प्रोजेक्ट की ज़रूरत की 5 अलग code libraries को download और install करता है
हज़ारों files के साथ node_modules फ़ोल्डर बनाता है
इन dependencies को याद रखने के लिए package.json को update करता है

हर library क्या करती है:

express: web server बनाती है जो API requests handle करता है
axios: दूसरी APIs (जैसे Spotify) को HTTP requests भेजता है
sentiment: emotions/mood detect करने के लिए text analyze करती है
dotenv: secret API keys को safely store करती है
spotify-web-api-node: music data पाने के लिए Spotify से connect करती है

अब file फिर open folder पर जाकर और mood-music-api नाम का फ़ोल्डर search करके उसे open करके अपना फ़ोल्डर खोलें।

अब आपको अपने explorer में Mood-MUSIC-API नाम का फ़ोल्डर दिखना चाहिए जिसमें node modules, package-lock.json और package.json फ़ाइल हो।

अपनी Spotify API Keys प्राप्त करना (Step-by-Step)

अब आप एक नई file बनाना चाहते हैं और उसे .env नाम देना चाहते हैं। ऐसा करने के लिए आप File पर क्लिक कर सकते हैं फिर New File पर और .env type कर सकते हैं फिर enter दबा सकते हैं और file name फिर से .env type करके Create File पर क्लिक कर सकते हैं।

इस फ़ाइल में कुछ भी enter करने से पहले हमें अपनी API keys प्राप्त करनी होंगी।

चरण 1: Spotify Developer Account बनाएं

जाएं: developer.spotify.com

आपको क्या दिखेगा:

टॉप राइट में "Log in" link
यदि आपके पास Spotify नहीं है: "Sign up" पर क्लिक करें (यह free है!)
यदि आपके पास Spotify है: अपना existing account use करें

महत्वपूर्ण: आपको Spotify Premium की ज़रूरत नहीं है - free accounts भी API access के लिए fine काम करते हैं!

चरण 2: अपना App बनाएं

लॉग इन के बाद:

"Create app" पर क्लिक करें

Form भरें:

App name: Mood Music API
App description: AI-powered mood playlist generator
Website: http://localhost:3000 (अभी के लिए)
Redirect URI: https://localhost:3000/callback

आप कौन सी APIs use करने की योजना बना रहे हैं?

✅ "Web API" को check करें
✅ "Web Playback SDK" को check करें (optional, future features के लिए)

Terms से agree करें और "Save" पर क्लिक करें

चरण 3: अपनी Secret Keys प्राप्त करें

अपना app बनाने के बाद:

आपको अपना app dashboard दिखेगा
Basic Information के नीचे आपको दो महत्वपूर्ण जानकारी दिखेंगी:

Client ID: abc123def456... (visible, 32 characters)
Client Secret: [Show client secret] (reveal करने के लिए click करें)

"Show client secret" पर क्लिक करें अपनी secret key reveal करने के लिए
दोनों keys copy करें - आपको अगले step में इनकी ज़रूरत होगी!

ये keys क्या करती हैं:

Client ID: आपके app की public identifier (username की तरह)
Client Secret: आपके app का password (इसे private रखें!)

चरण 4: Keys को अपने Project में Add करें

अपनी keys को आपकी बनाई गई .env file में add करें:

SPOTIFY_CLIENT_ID=your_actual_client_id_here
SPOTIFY_CLIENT_SECRET=your_actual_client_secret_here
PORT=3000

अपने changes save करने के लिए ctrl + s या cmd + s या File फिर save पर click करें।

चरण 5: अपने Secrets को Protect करें

महत्वपूर्ण: अपना Client Secret कभी भी publicly share न करें!

Terminal में निम्नलिखित commands का उपयोग करके .env को अपनी .gitignore file में add करें:

# .gitignore file बनाएं
# या macOS/Linux पर
touch .gitignore

# या PowerShell
New-Item -Path ".gitignore" -ItemType "file"
# या और भी सरल: 
echo $null > .gitignore

# .gitignore में यह line add करें:
.env
node_modules/

अपने changes save करने के लिए ctrl + s या cmd + s या File फिर save पर click करें।

Mood Detection Engine

एक file बनाएं और उसे moodAnalyzer.js नाम दें - यहां magic होता है।

File में निम्नलिखित code add करें और अपने changes save करें।

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

class MoodAnalyzer {
  analyzeMood(text) {
    const result = sentiment.analyze(text);
    
    // Context clues के साथ Enhanced mood detection
    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);
    
    // Specific mood keywords check करें
    for (const [mood, keywords] of Object.entries(moodKeywords)) {
      if (keywords.some(keyword => lowerText.includes(keyword))) {
        detectedMood = mood;
        confidence += 2;
        break;
      }
    }
    
    // Sentiment score पर fallback
    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();

Spotify Playlist Wizard

एक file बनाएं और उसे playlistGenerator.js नाम दें। फिर निम्नलिखित code add करें और अपने changes save करें:

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('🔑 Spotify authentication attempt कर रहे हैं...');
      console.log('Client ID:', process.env.SPOTIFY_CLIENT_ID ? 
        `${process.env.SPOTIFY_CLIENT_ID.substring(0, 8)}...` : 'MISSING');
      console.log('Client Secret:', process.env.SPOTIFY_CLIENT_SECRET ? 
        `${process.env.SPOTIFY_CLIENT_SECRET.substring(0, 8)}...` : 'MISSING');
      
      const data = await this.spotifyApi.clientCredentialsGrant();
      this.spotifyApi.setAccessToken(data.body['access_token']);
      console.log('🎵 Spotify successfully connect हो गया!');
    } catch (error) {
      console.error('❌ Spotify connection fail हो गया:', error.message);
      console.error('Status code:', error.statusCode);
      console.error('यह आमतौर पर invalid API credentials का मतलब है');
    }
  }
  
  // ... (आपके document में दिखाए गए बाकी code)
}

module.exports = PlaylistGenerator;

Mind-Reading API Server

एक file बनाएं और उसे server.js नाम दें, निम्नलिखित code add करें और अपने changes save करें:

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

// पुराने Node.js versions के लिए node-fetch add करें
let fetch;
if (typeof globalThis.fetch === 'undefined') {
  console.log('📦 Node.js fetch available नहीं है, node-fetch package use कर रहे हैं...');
  try {
    fetch = require('node-fetch');
  } catch (error) {
    console.error('❌ कृपया node-fetch install करें: npm install node-fetch');
    process.exit(1);
  }
} else {
  fetch = globalThis.fetch;
  console.log('✅ Built-in Node.js fetch use कर रहे हैं');
}

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(\`
    <!DOCTYPE html>
    <html>
    <head>
        <title>Mind-Reading Music API</title>
        <style>
            /* Beautiful gradient styling और custom audio controls */
        </style>
    </head>
    <body>
        <div class="container">
            <h1>🧠🎵 Mind-Reading Music API</h1>
            <p class="subtitle">मुझे बताएं आप कैसा महसूस कर रहे हैं, और मैं आपके mood के लिए perfect playlist बनाऊंगा!</p>
            
            <textarea id="moodText" placeholder="Type करें आप कैसा महसूस कर रहे हैं..."></textarea>
            <button onclick="generatePlaylist()">🎧 मेरी Playlist Generate करें</button>
            
            <div id="result" style="display:none;" class="result">
                <!-- Results यहां appear होंगे -->
            </div>
        </div>
        
        <script>
            // Playlist generation और audio controls के लिए JavaScript
        </script>
    </body>
    </html>
  \`);
});

// Magic endpoint
app.post('/api/mood-playlist', async (req, res) => {
  // API logic यहां
});

app.listen(PORT, () => {
  console.log(`🚀 Mind-Reading Music API http://localhost:${PORT} पर run हो रहा है`);
  console.log('🧠 Moods analyze करने और playlists generate करने के लिए ready!');
});

चरण 5: अपनी Emotional AI को Test करें

अपना server start करें:

node server.js

आपको कुछ इस तरह दिखना चाहिए:

अब अपना web browser खोलें और ऊपर image में दिखाए गए local link (http://localhost:3000) पर जाकर अपनी Mind-Reading Music API को test करें!

बचने योग्य Common Pitfalls

Spotify API limits: Free tier की rate limits हैं। Production use के लिए responses cache करें और retry logic implement करें।
Mood misinterpretation: Edge cases test करें जैसे sarcasm ("great, another Monday...") जो sentiment analysis को confuse कर सकता है।
Empty playlists: हमेशा उन cases को handle करें जहां Spotify कोई recommendations return नहीं करता by providing fallback genres।
API key exposure: अपनी .env file कभी commit न करें। Production में environment variables use करें।

अगले Steps

अब हमने वास्तव में कुछ cool बनाया है! इसे और भी बेहतर बनाने के तरीके:

User accounts add करें: Mood history और playlist preferences store करें
Machine learning: Accuracy improve करने के लिए user feedback पर custom models train करें
Social features: Users को friends के साथ mood playlists share करने दें
Voice integration: Voice mood detection के लिए speech-to-text APIs के साथ connect करें
Wearable integration: Deeper mood insights के लिए heart rate और activity data read करें
Deploy और scale: Caching के लिए Redis use करें, proper authentication implement करें

आपकी Mind-Reading Music API अब human emotions को understand कर सकती है और perfect soundtracks के साथ respond कर सकती है। AI sentiment analysis और music curation का यह combination personalized experiences के future को represent करता है। Possibilities endless हैं!

हमारे अगले tutorial के लिए नज़र रखें जहां हम इस app को और develop करेंगे...