blkluv / stellar

AI-powered Spotify companion web app that provides personalized playlists based on prompts, music preferences, celestial events and local weather.

---

StellarMix is a Spotify companion and controller application that crafts the ultimate playlist for your mood using OpenAI to blending your music tastes with cues from the weather, time of day, moon phases and celestial events.

🌠 Features

• AI-Powered Mood Detection: Input your mood and let OpenAI search Spotify for the perfect playlists.
• Celestial Influences: Our unique algorithm considers the positions of celestial bodies to curate your playlist.
• Weather Integration: Whether it's sunny, rainy, or snowy, your current weather plays a part in the song selection.
• Seamless Spotify Control: Enjoy the familiarity of Spotify with the unique twist of Stellar Mix brainpower.

🚀 Getting Started

1. Clone the Repository

   git clone https://github.com/yourusername/stellar-mix.git
   cd stellar-mix
   

2. Install Dependencies

   npm install

3. Set Up Environment Variables

Rename .env.example to .env Fill in the required keys from your Spotify Developer Dashboard

4. Run the App

   npm start

🛰️ Tech Stack

Frontend: React, Redux APIs: Spotify, OpenAI, OpenWeather API, SunCalc

📜 License

This project is licensed under the MIT License - see the LICENSE.md file for details.