Skip to content

yaseenscodemuseum/MewFlo

Repository files navigation

MewFlo - AI Playlist Maker 🎵

MewFlo is an innovative web application that leverages artificial intelligence to create personalized music playlists. Built with modern web technologies, it provides an intuitive interface for users to generate playlists based on their preferences and mood.

🌐 Live Demo: https://mewflo.vercel.app

🌟 Features

  • AI-powered playlist generation
  • Spotify integration
  • Modern, responsive UI built with React and Tailwind CSS
  • Real-time playlist creation and modification
  • User-friendly interface with smooth animations

🛠️ Tech Stack

Frontend

  • React 18
  • TypeScript
  • Vite
  • Tailwind CSS
  • Radix UI Components
  • React Router DOM

Backend

  • Node.js
  • Express
  • TypeScript
  • Spotify Web API
  • Google AI Integration
  • OpenAI Integration

🚀 Getting Started

Prerequisites

  • Node.js (>= 18.0.0)
  • npm or yarn
  • Spotify Developer Account
  • Google AI API Key
  • OpenAI API Key

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/MewFlo.git
cd MewFlo
  1. Install frontend dependencies:
npm install
  1. Install backend dependencies:
cd backend
npm install
  1. Create a .env file in the root directory with the following variables:
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
GOOGLE_AI_API_KEY=your_google_ai_api_key
OPENAI_API_KEY=your_openai_api_key

Running Locally

  1. Start the backend server:
cd backend
npm run dev
  1. In a new terminal, start the frontend development server:
npm run dev
  1. Open your browser and navigate to http://localhost:5173

🏗️ Building for Production

  1. Build the frontend:
npm run build
  1. Build the backend:
cd backend
npm run build

🚢 Deployment

The project is configured for deployment on Vercel. The vercel.json file contains the necessary configuration for deployment.

To deploy:

  1. Push your changes to GitHub
  2. Connect your repository to Vercel
  3. Configure the environment variables in Vercel's dashboard
  4. Deploy!

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📧 Contact

My Instagram - @yaleftonseen

Project Link: https://github.com/yourusername/MewFlo

About

AI Playlist Maker

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors