Upload 2 files

README.md

@@ -1,20 +1,99 @@
----
-title: Vibesync
-emoji: 🚀
-colorFrom: red
-colorTo: red
-sdk: docker
-app_port: 8501
-tags:
-- streamlit
-pinned: false
-short_description: Streamlit template space
-license: apache-2.0
----
-
-# Welcome to Streamlit!
-
-Edit `/src/streamlit_app.py` to customize this app to your heart's desire. :heart:
-
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).
+# VibeSync - AI-Powered Playlist Generator 🎵
+
+Create personalized music playlists using AI personality analysis and export them directly to Spotify!
+
+## Features
+
+✨ **AI-Powered Recommendations** - Uses Groq LLM to analyze your personality quiz and curate perfect songs  
+🎧 **Spotify Integration** - Export playlists directly to your Spotify account  
+🎨 **Beautiful UI** - Premium gradient design with smooth animations  
+💬 **Smart Suggestions** - Ask AI for more songs based on your preferences  
+
+## Setup Instructions
+
+### 1. Install Dependencies
+
+```bash
+pip install -r requirements.txt
+```
+
+### 2. Get API Keys
+
+#### Groq API Key (Required for AI recommendations)
+1. Go to [Groq Console](https://console.groq.com/)
+2. Sign up or log in
+3. Create a new API key
+4. Copy the key
+
+#### Spotify API Credentials (Optional - for playlist export)
+1. Go to [Spotify Developer Dashboard](https://developer.spotify.com/dashboard)
+2. Log in with your Spotify account
+3. Click "Create an App"
+4. Fill in app name and description
+5. In app settings, add `http://localhost:8501` to "Redirect URIs"
+6. Copy your **Client ID** and **Client Secret**
+
+### 3. Configure Environment Variables
+
+Create a `.env` file in the project directory:
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` and add your credentials:
+
+```
+GROQ_API_KEY=your_groq_api_key_here
+SPOTIFY_CLIENT_ID=your_spotify_client_id_here
+SPOTIFY_CLIENT_SECRET=your_spotify_client_secret_here
+SPOTIFY_REDIRECT_URI=http://localhost:8501
+```
+
+### 4. Run the App
+
+```bash
+streamlit run app.py
+```
+
+The app will open in your browser at `http://localhost:8501`
+
+## How to Use
+
+1. **Start the Quiz** - Click "Start Your Vibe Journey"
+2. **Connect Spotify** (Optional) - Click "Connect Spotify" to link your account
+3. **Answer Questions** - Complete 8 personality questions about your mood and preferences
+4. **Get Your Playlist** - AI will generate 10-12 personalized song recommendations
+5. **Export to Spotify** - If connected, create the playlist in your Spotify account
+6. **Add More Songs** - Use AI to get additional suggestions
+
+## Demo Mode
+
+The app works without API keys in demo mode:
+- Without Groq API: Shows a pre-defined playlist
+- Without Spotify: Can't export playlists (view only)
+
+For the best experience, configure both APIs!
+
+## Troubleshooting
+
+**Spotify Authentication Issues:**
+- Make sure the redirect URI in your Spotify app settings matches exactly: `http://localhost:8501`
+- Clear `.spotify_cache` file if you have authentication errors
+- Check that your Spotify app is not in Development Mode restrictions
+
+**Groq API Errors:**
+- Verify your API key is correct
+- Check your Groq account has available credits
+- Ensure you have internet connection
+
+## Technologies Used
+
+- **Streamlit** - Web framework
+- **Groq** - AI/LLM for song recommendations
+- **Spotipy** - Spotify Web API wrapper
+- **Python-dotenv** - Environment variable management
+
+## License
+
+MIT License - Feel free to use and modify!

requirements.txt

@@ -1,3 +1,5 @@
-altair
-pandas
-streamlit
+streamlit
+groq
+spotipy
+python-dotenv
+