foxdot-composer

# 🎹 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.

![Python](https://img.shields.io/badge/Python-3.9+-blue)
![Supercollider](https://img.shields.io/badge/SuperCollider-3.14.1+-orange)
![License](https://img.shields.io/badge/License-MIT-green)

## ✨ 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

```bash
pip install -r requirements.txt
```

### 2. Set API Key

```bash
# 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](https://aistudio.google.com/apikey).

### 3. Setup SuperCollider & FoxDot

**Install SuperCollider:**
- Download from [supercollider.github.io](https://supercollider.github.io/downloads)

**Start SuperCollider and run:**
```supercollider
FoxDot.start
```

**Wait for:** `FoxDot Quark ready!` message

### 4. Run the Str