{"id":28322769,"url":"https://github.com/slewie/genius-lyrics-decoder","last_synced_at":"2025-08-20T05:20:51.270Z","repository":{"id":293806972,"uuid":"972278738","full_name":"slewie/genius-lyrics-decoder","owner":"slewie","description":"A powerful web application that provides deep analysis and interpretation of song lyrics using AI. The project combines the Genius API for lyrics retrieval with advanced LLM to offer meaningful insights into songs.","archived":false,"fork":false,"pushed_at":"2025-07-19T10:44:58.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-19T15:45:57.644Z","etag":null,"topics":["genius","langchain","llm","lyricsgenius"],"latest_commit_sha":null,"homepage":"https://genius-lyrics-decoder.streamlit.app/","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/slewie.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}},"created_at":"2025-04-24T20:18:58.000Z","updated_at":"2025-07-19T10:44:59.000Z","dependencies_parsed_at":"2025-06-23T21:43:46.547Z","dependency_job_id":null,"html_url":"https://github.com/slewie/genius-lyrics-decoder","commit_stats":null,"previous_names":["slewie/genius-lyrics-decoder"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/slewie/genius-lyrics-decoder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slewie%2Fgenius-lyrics-decoder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slewie%2Fgenius-lyrics-decoder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slewie%2Fgenius-lyrics-decoder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slewie%2Fgenius-lyrics-decoder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slewie","download_url":"https://codeload.github.com/slewie/genius-lyrics-decoder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slewie%2Fgenius-lyrics-decoder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271268859,"owners_count":24730026,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-20T02:00:09.606Z","response_time":69,"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":["genius","langchain","llm","lyricsgenius"],"created_at":"2025-05-25T14:11:15.505Z","updated_at":"2025-08-20T05:20:51.264Z","avatar_url":"https://github.com/slewie.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎵 Genius Lyrics Decoder\n\nA powerful web application that provides deep analysis and interpretation of song lyrics using AI. The project combines the Genius API for lyrics retrieval with advanced language models to offer meaningful insights into songs.\n\n## 🌟 Features\n\n- **Lyrics Retrieval**: Automatically fetches song lyrics using the Genius API\n- **AI-Powered Analysis**: Provides two levels of interpretation:\n  - Overall song summary and thematic analysis\n  - Detailed line-by-line interpretation of lyrics\n- **User-Friendly Interface**: Clean and simple Streamlit-based frontend\n- **Modern Architecture**: FastAPI backend with async support\n\n## 🛠️ Technical Stack\n\n### Backend\n- **FastAPI**: Modern, fast web framework for building APIs\n- **LangChain**: For structured interaction with language models\n- **Genius API**: For retrieving song lyrics\n- **Python 3.9+**: Async support and modern Python features\n\n### Frontend\n- **Streamlit**: For building the interactive web interface\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Python 3.9 or higher\n- Genius API token\n- LLM API access\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/yourusername/genius-lyrics-decoder.git\ncd genius-lyrics-decoder\n```\n\n2. Install dependencies:\n```bash\npip install -r requirements.txt\n```\n\n3. Set up environment variables:\nCreate a `.env` file in the root directory with:\n```env\nGENIUS_API_TOKEN=your_genius_token_here\n```\n\n### Running the Application\n\n1. Start the backend server:\n```bash\npython -m backend.main\n```\n\n2. Start the frontend:\n```bash\nstreamlit run frontend/app.py\n```\nor\n```bash\npython -m frontend/bot.py\n```\n\n## 🎯 Usage\n\n1. Open the web interface (typically at `http://localhost:8501`)\n2. Enter the artist name and song title\n3. Click \"Analyze\" to get:\n   - A comprehensive summary of the song's themes and motifs\n   - Detailed interpretations of paired lyrics\n\n## 🔍 How It Works\n\n1. **Input Processing**: User provides artist and song information\n2. **Lyrics Retrieval**: System fetches lyrics using the Genius API\n3. **Analysis Pipeline**:\n   - Generates an overall summary of the song\n   - Processes lyrics in pairs for more contextual interpretation\n   - Uses AI to provide meaningful interpretations\n4. **Result Presentation**: Displays both summary and line-by-line analysis in a user-friendly format\n\n\n## 🔮 Future Improvements\n\n- Multi-language support\n- More detailed musical context analysis\n- Support for comparing multiple songs\n- Enhanced error handling and user feedback\n- Caching mechanism for frequently requested songs","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslewie%2Fgenius-lyrics-decoder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslewie%2Fgenius-lyrics-decoder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslewie%2Fgenius-lyrics-decoder/lists"}