StemGolf-VocalWave

An open-source AI-powered application for vocal analysis and music stem separation using Google Gemini API

📋 About

StemGolf-VocalWave is a 100% open-source web application that combines vocal wave analysis with music stem separation capabilities. Powered by Google's Gemini API, this app helps musicians, producers, and audio engineers extract, analyze, and manipulate individual instrument stems from audio tracks.

This is a community-driven project built by developers for developers. We welcome contributions from anyone interested in improving audio technology!

Key Features

• 🎵 Audio Stem Separation - Isolate vocals, drums, bass, and other instruments from mixed audio
• 🎤 Vocal Analysis - Advanced voice and vocal pattern recognition using AI
• 🧠 AI-Powered Insights - Powered by Google Gemini for intelligent audio understanding
• 🚀 Real-time Processing - Fast and efficient audio processing
• 💾 Easy Export - Download separated stems in multiple formats
• 🎨 User-Friendly Interface - Intuitive design for seamless user experience

Use Cases

• Music production and beat-making
• Vocal coaching and training
• Podcast and voice content editing
• Educational audio analysis
• DJ mixing and remixing
• Audio restoration

🚀 Quick Start

Prerequisites: Node.js (v18 or higher)

1. Clone the repository:

   git clone https://github.com/EGZeelie/StemGolf-VocalWave.git
   cd StemGolf-VocalWave

2. Install dependencies:

   npm install

3. Set up environment variables:

   • Create or update the .env.local file
   • Add your Gemini API key:

   GEMINI_API_KEY=your_api_key_here
   

   • Get your API key from Google AI Studio

4. Run the app:

   npm run dev

5. Open your browser and navigate to http://localhost:3000

📱 Screenshots

Screenshot 1

Screenshot 2

Screenshot 3

Screenshot 4

Screenshot 5

Screenshot 6

Screenshot 7

Screenshot 8

Screenshot 9

Screenshot 10

🛠️ Tech Stack

• Frontend: React / Next.js
• AI Engine: Google Gemini API
• Styling: Tailwind CSS / CSS Modules
• Backend: Node.js
• Deployment: Google AI Studio

📦 Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm start - Start production server
• npm run lint - Run linting checks

🔑 Environment Variables

Required environment variables in .env.local:

GEMINI_API_KEY=your_gemini_api_key

🤝 Contributing

We love contributions! This is an open-source project and we welcome developers of all skill levels.

How to Contribute

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

Types of Contributions Welcome

• 🐛 Bug Reports - Found a bug? Let us know!
• ✨ New Features - Have an idea? Submit a PR!
• 📚 Documentation - Help improve our docs
• 🎨 Design Improvements - Make the UI/UX better
• ⚡ Performance Improvements - Optimize the code
• 🧪 Tests - Help us improve test coverage

📄 License

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

What this means:

• ✅ You can use this code for commercial projects
• ✅ You can modify and distribute the code
• ✅ You can use this privately
• ✅ You must include a copy of the license
• ⚠️ No warranty is provided

🔗 Links

• View on AI Studio
• Google Gemini API Documentation
• Google AI Studio
• GitHub Repository

👤 Author

EGZeelie

---

Made with ❤️ by the open-source community

If you find this project helpful, please consider giving it a ⭐ star!