joshinar/multi-llm-rap-battle

🎤 Multi-LLM Rap Battle Arena

A dynamic rap battle application where 5 different AI models compete to create the best rap verses! Watch as OpenAI, Gemini, DeepSeek, Claude, and Groq go head-to-head in a lyrical showdown.

🎭 How It Works

1. Click the "Initiate Multi-LLM Rap Battle" button
2. Watch as each AI creates a 12-line rap verse about the motion: "Built from the bottom, now I architect the rise"
3. See the final judgment where an AI judge determines the winner based on flow, creativity, wordplay, and overall impact

🎨 Features

• Beautiful Card UI: Each rap is displayed in stunning gradient cards with hover effects
• Large, Readable Fonts: Easy-to-read lyrics with enhanced typography
• Standout Judgment: The final judgment card features a vibrant rainbow gradient with shining animation
• Real-time Generation: Watch as each AI model creates its rap individually
• Professional Styling: Modern, responsive design with Roboto fonts

🤖 AI Models Used

• OpenAI GPT-4o-mini: Fast and creative rap generation
• Google Gemini Pro: Innovative wordplay and flow
• DeepSeek Coder: Technical precision in lyrics
• Anthropic Claude 3.5 Sonnet: Sophisticated storytelling
• Groq Llama3-70B: Raw energy and authenticity

🏆 Judging Criteria

The AI judge evaluates each rap based on:

• Flow: Rhythm and musicality
• Creativity: Original ideas and concepts
• Wordplay: Clever use of language
• Overall Impact: Emotional and cultural resonance

🚀 Technology Stack

• Gradio: Beautiful web interface
• CrewAI: Multi-agent orchestration framework
• Multiple LLMs: Integration with various AI models
• Custom CSS: Advanced styling and animations

📝 Setup Instructions

1. Environment Variables: Set up your API keys in the Hugging Face Space settings:

   • OPENAI_API_KEY
   • GOOGLE_API_KEY (for Gemini)
   • DEEPSEEK_API_KEY
   • ANTHROPIC_API_KEY
   • GROQ_API_KEY

2. Deploy: The app will automatically deploy when you push to this repository

🎵 Sample Motion

The current motion is: "Built from the bottom, now I architect the rise"

This theme explores themes of:

• Personal growth and transformation
• Overcoming adversity
• Building success from humble beginnings
• Leadership and influence

🔧 Customization

You can easily modify:

• The rap motion by changing the default_motion variable
• The number of lines (currently 12) in the agent goals
• The judging criteria in the judge agent's configuration
• The UI styling through the custom CSS

📱 Usage

Simply click the button and watch the magic happen! Each AI will generate its rap, and then the judge will determine the winner. The entire process takes about 1-2 minutes depending on API response times.

---

Powered by CrewAI and Gradio 🤖✨