Skip to content

hngx-org/song-recommender-ai

Repository files navigation

SONGSCRIPT AI - Music Playlist Recommendation App

Welcome to SongScript AI, your go-to app for generating personalized music playlists using the power of OpenAI's chat completions API. Whether you're in the mood for some tunes, want to discover new music, or need a playlist for a specific occasion, SongScript AI has you covered.

Features

1. Authentication

  • Securely create and manage your account.
  • Protect your personal data and playlists.

2. Subscription

  • Unlock premium features with a subscription plan.
  • Enjoy an ad-free experience and access to exclusive content.

3. Chat with AI

  • Engage in natural language conversations with AI.
  • Get personalized music playlist recommendations based on your mood, artist name, or song lyrics.

4. Playlist Generation

  • Generate custom playlists containing 10 songs tailored to your input.
  • Discover new music and rediscover old favorites effortlessly.

5. Chat History

  • Save your chat conversations with the AI for future reference.
  • Store and access your chat history securely using Firebase Firestore.

6. Copy to Clipboard

  • Easily copy your generated playlists to the clipboard.
  • Share your playlists with friends on your favorite messaging apps.

Getting Started

Follow these steps to set up and run the SongScript AI app on your local development environment:

  1. Clone the Repository

    git clone https://github.com/YourOrganization/SongScriptAI.git
  2. Install Dependencies

    cd SongScriptAI
    flutter pub get
  3. Configuration

    • Configure your Firebase project for authentication and Firestore database.
    • Set up your OpenAI API integration.
  4. Run the App

    flutter run
  5. Explore the App

    • Sign up for an account or log in if you already have one.
    • Subscribe to unlock unlimited experience.
    • Start chatting with AI and generating playlists.

Screenshots

screenshot-1696541956309 screenshot-1696541972585 screenshot-1696542275491 screenshot-1696542091561 screenshot-1696542105489

Tech Stack

  • Flutter: Front-end framework for building cross-platform mobile apps.
  • Firebase: Authentication and Firestore for user management and chat history storage.
  • OpenAI API: To power the AI chatbot for music recommendations.

Contributing

We welcome contributions from the open-source community. To contribute to SongScript AI, follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Make your changes and ensure the code passes all tests.
  4. Submit a pull request.

Support

If you encounter any issues or have questions, please reach out to us at [email protected].

Acknowledgments

We would like to express our gratitude to the open-source community and the following technologies that made SongScript AI possible:

Thank you for choosing SongScript AI for your music playlist needs! Enjoy the music journey!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •