Dreamscape Symphony is an AI-powered web app that transforms your dreams into personalized song lyrics and generates text-to-speech (TTS) audio. Using advanced natural language processing techniques, the app analyzes dream descriptions to extract key themes, named entities, and emotions, creating unique songs from your subconscious thoughts.

🚀 Features

Dream Analysis: Extracts named entities, sentiments, keywords, and themes from your dream descriptions.
Lyrics Generation: Produces personalized song lyrics in genres like Pop, Rock, Carnatic, Samba, and Hip-Hop.
Text-to-Speech (TTS): Converts the generated lyrics into speech so you can listen to the song based on your dream.
Image Upload: Option to upload images that relate to your dream and display them alongside the lyrics.
PDF Export: Download the generated lyrics and images as a well-formatted PDF, making it a great keepsake.
Downloadable TTS Audio: Allows users to download the generated TTS audio file of the lyrics.
Custom Themes: Supports light and dark mode for personalized user experience.

🖥️ Demo

You can try out the live version of Dreamscape Symphony here:

Live Demo on Streamlit Cloud

📖 Usage

Describe your dream: Enter a brief description of your dream in the input box.
Optional Image: Upload an image related to your dream to enhance the visualization.
Analyze Dream: Click the "Analyze Dream" button to extract named entities, keywords, and emotional tone from the dream.
Generate Song Lyrics: Choose a genre, then click "Generate Lyrics" to create a personalized song based on your dream.
Listen to the Song: Click "Listen to the Lyrics" to hear the generated lyrics using TTS.
Download PDF & Audio: You can download the lyrics and the album cover as a PDF, as well as the TTS audio file of the song.

🛠️ Installation

To run Dreamscape Symphony locally, follow these steps:

Prerequisites

Python 3.8 or higher
pip (Python package manager)

Clone the Repository

git clone https://github.com/your-username/dreamscape-symphony.git

cd dreamscape-symphony

Install Dependencies

Create a virtual environment and install the required dependencies listed in requirements.txt.

pip install -r requirements.txt

Add Your API Keys

Create a secrets.toml file in the .streamlit folder of the project and add your API key for the Hugging Face models.

[huggingface]

HUGGINGFACE_API_TOKEN=your_huggingface_api_token

Run the App

streamlit run app.py

🧑‍💻 Contributing

We welcome contributions! Follow these steps to contribute to Dreamscape Symphony:

Fork the repository.
Create a new branch: git checkout -b feature/your-feature-name.
Make your changes and commit them: ‘git commit -m 'Add some feature’.
Push the changes to your fork:git push origin feature/your-feature-name`.
Create a pull request.

Please ensure that your code follows the project's style guidelines and is well-documented.

💬 Acknowledgments

Thanks to the Streamlit community for providing an amazing framework to build and deploy web apps.
Thanks the Hugging Face team for their powerful NLP models.