Skip to content

kkrib412/RiffMind-AI

Repository files navigation

🎸 RiffMind AI - Your AI-Powered Guitar Companion

Kotlin Android Gemini AI Status

Analyze your riffs in real-time. Generate AI-powered backing tracks. Never practice alone again.

FeaturesTech StackSetupRoadmap


🎯 What It Does

RiffMind AI listens to your guitar playing in real-time, detects the musical key, and instantly generates custom backing tracks using Google's Lyria AI music generation API. It's like having a full band that adapts to whatever you play.

The Problem It Solves

Guitarists practicing alone need:

  • Backing tracks that match what they're playing
  • Quick key detection for improvisation
  • Accompaniment that adapts in real-time

Existing solutions require manual key input or pre-recorded loops. RiffMind AI listens and generates.


✨ Features

Current (v0.9)

  • 🎵 Live Riff Analysis - Real-time audio processing to detect musical keys
  • 🤖 AI Track Generation - Google Lyria API integration for custom backing tracks
  • 🎛️ Key Detection - Automatic musical key identification from live guitar input
  • 🎨 Clean Material Design UI - Modern Android interface with Jetpack Compose
  • 📱 Offline Caching - Stores generated tracks for offline playback

Coming Soon

  • 🎸 Multi-instrument support (bass, drums, keys)
  • 🎼 Style selection (blues, rock, jazz, metal)
  • 📊 Practice session analytics
  • ☁️ Cloud sync across devices
  • 🎵 Export to MIDI/audio files

🛠️ Tech Stack

Android/Kotlin

  • Jetpack Compose for UI
  • Kotlin Coroutines for async operations
  • Room for local caching

AI/Audio

  • Google Gemini API for key detection
  • Google Lyria API for music generation
  • AudioRecord API for real-time audio capture
  • FFT analysis for pitch detection

Architecture

  • MVVM pattern
  • Repository pattern for data layer
  • Dependency injection with Hilt

🚀 Getting Started

Prerequisites

  • Android Studio Hedgehog or later
  • Android device/emulator (API 26+)
  • Gemini API key (get one here)

Setup

  1. Clone the repository
git clone https://github.com/kkrib412/RiffMind-AI.git
cd RiffMind-AI
  1. Create .env file in project root
GEMINI_API_KEY=your_api_key_here
  1. Open in Android Studio

    • Let Gradle sync
    • Wait for dependencies to download
  2. Remove this line from app/build.gradle.kts

signingConfig = signingConfigs.getByName("debugConfig")
  1. Run on device or emulator

Microphone Permissions

The app requires microphone access for live audio analysis. Grant permissions when prompted.


📸 Screenshots

Coming soon - App is functional but UI polish in progress for Play Store submission


🎯 Roadmap to Play Store

Current Status: Functional beta, awaiting funding for Play Store developer account

Before Launch:

  • Add onboarding tutorial
  • Implement error handling for API failures
  • Add offline mode fallbacks
  • Complete UI polish
  • Beta testing with musicians
  • Privacy policy & terms

Target: Q3 2026


🎵 How It Works

  1. Audio Capture: App uses Android's AudioRecord API to capture guitar audio
  2. Pitch Detection: FFT analysis identifies fundamental frequencies
  3. Key Detection: Gemini API analyzes pitch patterns to determine musical key
  4. Track Generation: Lyria API generates backing track in detected key
  5. Playback: Seamless audio mixing with original guitar input

🤝 About

Built by Kenny Kriberney (@kkrib412)

I'm a self-taught developer transitioning from security ops to AI application development. This is my first Android app combining audio processing with generative AI.

Why This Project?

  • Solve a real problem I face as a guitarist
  • Learn Android/Kotlin
  • Explore AI music generation APIs
  • Build something musicians actually want

📄 License

MIT License - Free to use, modify, and learn from


🔗 Related Projects

  • ECHO - Family memory app with AI voice preservation
  • Sales-Coach-AI - AI-powered sales call analysis
  • Portfolio - Full project showcase

💡 Feedback & Contact

Have ideas? Find a bug? Want to collaborate?


⭐ Star this repo if you're excited about AI-powered music tools!

About

⚡ AI-powered guitar companion - Live riff analysis + AI backing track generation using Google Gemini & Lyria APIs. Native Android in Kotlin.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages