{"id":50409577,"url":"https://github.com/aldythnahak/moodtune_ai","last_synced_at":"2026-05-31T03:01:36.593Z","repository":{"id":357358668,"uuid":"1235511446","full_name":"AldythNahak/MoodTune_AI","owner":"AldythNahak","description":"AI music recommendation web app with Gemini AI, Spotify embeds, mood detection, and modern Streamlit UI.","archived":false,"fork":false,"pushed_at":"2026-05-12T11:38:12.000Z","size":9,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-12T13:30:59.786Z","etag":null,"topics":["ai","ai-assistant","chatbot","data-science","gemini-api","generative-ai","llm","machine-learning","music-chatbot","music-recommendation","nlp","python","python3","recommendation-system","spotify","spotify-api-consumer","spotify-api-wrapper","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AldythNahak.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-11T11:51:49.000Z","updated_at":"2026-05-12T11:38:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AldythNahak/MoodTune_AI","commit_stats":null,"previous_names":["aldythnahak/moodtune_ai"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/AldythNahak/MoodTune_AI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AldythNahak%2FMoodTune_AI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AldythNahak%2FMoodTune_AI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AldythNahak%2FMoodTune_AI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AldythNahak%2FMoodTune_AI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AldythNahak","download_url":"https://codeload.github.com/AldythNahak/MoodTune_AI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AldythNahak%2FMoodTune_AI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33717419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-assistant","chatbot","data-science","gemini-api","generative-ai","llm","machine-learning","music-chatbot","music-recommendation","nlp","python","python3","recommendation-system","spotify","spotify-api-consumer","spotify-api-wrapper","streamlit"],"created_at":"2026-05-31T03:01:35.798Z","updated_at":"2026-05-31T03:01:36.584Z","avatar_url":"https://github.com/AldythNahak.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎧 MoodTune AI\n\nMoodTune AI is an AI-powered music recommendation chatbot built using Streamlit, Gemini API, and Spotify API.\n\nThe app analyzes the user's mood, genre preference, and prompts to generate personalized song recommendations with playable Spotify embeds.\n\n\u003cimg width=\"1511\" height=\"903\" alt=\"Screenshot 2026-05-12 at 6 21 09 PM\" src=\"https://github.com/user-attachments/assets/22751a7d-7410-46bd-9050-62151b5cf20b\" /\u003e\n\n---\n\n# ✨ Features\n\n* 🤖 AI Music Recommendation using Gemini\n* 🎵 Spotify Embedded Music Player\n* 🎧 Mood-based Playlist Generator\n* 🎙️ DJ Mode for energetic recommendations\n* 🎨 Modern Spotify-inspired UI\n* 💬 Chat-style interaction\n* 🔥 Trending recommendation section\n* 🖼️ Album cover previews\n* ⚡ Fast Gemini integration\n\n---\n\n# 🛠️ Tech Stack\n\n* Python\n* Streamlit\n* Gemini API\n* Spotify API\n* Spotipy\n* Streamlit Lottie\n* HTML/CSS\n\n---\n\n# 📦 Installation\n\n## 1. Clone Repository\n\n```bash\ngit clone https://github.com/AldythNahak/MoodTune_AI.git\ncd MoodTune_AI\n```\n\n---\n\n## 2. Create Virtual Environment (Optional)\n\n### Mac/Linux\n\n```bash\npython3 -m venv venv\nsource venv/bin/activate\n```\n\n### Windows\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\n```\n\n---\n\n## 3. Install Dependencies\n\n```bash\npip install -r requirements.txt\n```\n\n---\n\n# 🔑 Environment Variables\n\nCreate a `.env` file in the root folder.\n\n```env\nGEMINI_API_KEY=your_gemini_api_key\n\nSPOTIFY_CLIENT_ID=your_spotify_client_id\nSPOTIFY_CLIENT_SECRET=your_spotify_client_secret\n```\n\n---\n\n# 🤖 Gemini API Setup\n\n1. Open Google AI Studio\n   https://aistudio.google.com/\n\n2. Create API Key\n\n3. Copy the API key into `.env`\n\n---\n\n# 🎵 Spotify API Setup\n\n1. Open Spotify Developer Dashboard\n   https://developer.spotify.com/dashboard\n\n2. Create an App\n\n3. Copy:\n\n* Client ID\n* Client Secret\n\n4. Paste into `.env`\n\nNo OAuth login required because this project uses Spotify Client Credentials.\n\n---\n\n# ▶️ Run The App\n\n```bash\nstreamlit run app.py\n```\n\n---\n\n# 🎯 Example Prompts\n\n```text\nGive me chill songs like wave to earth\n\nSad songs for midnight drive\n\nWorkout EDM playlist\n\nRomantic jazz music\n\nSongs similar to Joji\n```\n\n---\n\n# 📂 Project Structure\n\n```text\nMoodTune_AI/\n│\n├── app.py\n├── requirements.txt\n├── README.md\n├── .env\n```\n\n---\n\n# 📌 Requirements\n\nExample `requirements.txt`\n\n```txt\nstreamlit\ngoogle-genai\npython-dotenv\nrequests\nspotipy\nstreamlit-lottie\n```\n\n---\n\n# 🚀 Future Improvements\n\n* Spotify OAuth Login\n* Playlist Save to Spotify\n* Music History Memory\n* AI Mood Detection\n* Voice Assistant\n* Lyrics Integration\n* YouTube Music Support\n\n---\n\n# 👨‍💻 Author\n\nDeveloped by *Aldyth Nahak*\n[GitHub](https://github.com/AldythNahak) | [LinkedIn](https://linkedin.com/in/aldythnahak)\n---\n\n# 📄 License\n\nThis project is for training \"Maju Bareng AI for Data Scientists | 9 may | LLM - Based Tools and Gemini API Integration for Data Scientists\" Final Project purposes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faldythnahak%2Fmoodtune_ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faldythnahak%2Fmoodtune_ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faldythnahak%2Fmoodtune_ai/lists"}