# Radio AI

> Your Personalized AI Radio Station

## Summary
Radio AI is a full-stack platform that generates a continuous, personalized 24/7 radio experience. It orchestrates generative AI tools—**Suno** for audio and **Google Gemini** for lyrical/thematic metadata—to create original high-fidelity music on the fly. The system handles everything from creative generation to live broadcasting via FFmpeg.

## Core Features
- **AI Music Synthesis**: Automates music creation using Suno API based on structured prompts.
- **Twin-AI Workflow**: Uses Google Gemini to generate rich metadata (lyrics, artist backstories, album themes) which feeds into the audio generation process.
- **Automated Broadcasting**: Maintains a nonstop radio stream (RTMP) with dynamically generated video overlays ("Now Playing" visuals).
- **Personalized Experience**: Users can vote on tracks, impacting future generation and playlist curation.
- **Album Curation**: Logic to group generated tracks into cohesive albums with consistent styles.

## Technical Stack
- **Frontend**: React 18, Vite, Tailwind CSS
- **Backend**: Node.js, Express
- **Persistence**: MongoDB (Data), Redis (Cache/Session), Cloudflare R2 (Media Storage)
- **Media**: FFmpeg (Stream encoding & overlay generation)

## Navigation
- `/`: Main player interface and radio stream.
- `/creator`: Tools for generating new songs and albums (Admin/Creator role).
- `/auth/google`: OAuth entry point.