AI music producer agent using SuperComposer and FoxDot. Generate and live code music with natural language through a beautiful Streamlit interface.

🎹 FoxDot AI Music Agent

Create music with AI using natural language. Generate and live code music using Google Gemini and FoxDot, with real-time streaming, AI thinking visualization, and auto-execution in SuperCollider.

✨ Features

🎨 Beautiful Streamlit UI

• Real-time Streaming - See AI responses stream in character by character
• Thinking Visualization - Watch the AI's reasoning process unfold
• Tool Call Indicators - Live function call execution with code preview
• Music State Panel - Live view of BPM, scale, root, and active layers

🤖 AI-Powered Music Creation

• Natural Language Interface - Describe music in plain English
• Genre Understanding - Knows house, techno, lo-fi, hip-hop, ambient, and more
• Intelligent Layering - AI maintains context of what's playing
• Continuous Evolution - Build and modify compositions layer by layer

🎵 FoxDot Integration

• Global Environment - Shared FoxDot state like the original working code
• Auto-execution - Code runs immediately in SuperCollider (default ON)
• 50+ Synths - Full knowledge of FoxDot synthesizers
• Effects & Scales - Complete access to FoxDot's musical capabilities

🚀 Quick Start

1. Install Dependencies

pip install -r requirements.txt

2. Set API Key

# Set environment variable
export GOOGLE_API_KEY="your-api-key-here"

# Or enter it directly in the Streamlit UI

Get your API key from Google AI Studio.

3. Setup SuperCollider & FoxDot

Install SuperCollider:

• Download from supercollider.github.io

Start SuperCollider and run:

FoxDot.start

Wait for: FoxDot Quark ready! message

4. Run the Str