Skip to content

Club Goose delivers hands-free music creation through intuitive voice commands and real-time audio synthesis, and dynamic visual effects to create an immersive conducting experience that responds naturally to your voice.

Notifications You must be signed in to change notification settings

CodingWCal/club-goose

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

6 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽต Club Goose - Voice-Controlled Music Creation

Built for the "No Keyboards Allowed" Hackathon ๐ŸšซโŒจ๏ธ

A revolutionary hands-free music creation experience powered by voice commands and AI agents. Conduct your own electronic dance music with nothing but your voice!

Club Goose Demo Voice Control AI Powered

๐ŸŽช What is Club Goose?

Club Goose transforms music production into an immersive, hands-free experience. Simply speak to control melody, layers, and themes while enjoying reactive visuals that pulse with the beat. Our dancing goose mascot adds playful character to the experience, making music production accessible and engaging for users of all skill levels. Currently works 100% with just voice commands and will be implementing gesture controls in the future!

๐ŸŽฏ Key Features

  • ๐ŸŽค Voice Control: Complete hands-free operation using natural speech
  • ๐ŸŽต EDM House Music: Professional-quality electronic dance music generation
  • ๐ŸŽจ Reactive Visuals: Dynamic visualizations that respond to your music
  • ๐Ÿฆ† Dancing Goose: Playful mascot that reacts to the beat
  • ๐ŸŽช Club Mode: Immersive nightclub atmosphere with enhanced visuals
  • ๐Ÿ“ฑ No Keyboards Required: 100% voice-based interaction

๐Ÿค– AI Agent Development

This project was built using Goose AI agents for the "No Keyboards Allowed" hackathon, demonstrating the power of AI-assisted development:

๐Ÿฆ† Goose Agent Workflows Used:

  • ๐ŸŽต Audio Engineering: AI agents helped design and implement the complex Tone.js audio synthesis system
  • ๐ŸŽค Voice Recognition: Agents developed the sophisticated speech-to-command mapping system
  • ๐ŸŽจ Visual Effects: Agents created the dynamic visualizer and reactive animations
  • ๐Ÿ”ง State Management: AI helped architect the event-driven state management system
  • ๐ŸŽช UI/UX Design: Agents designed the immersive club-themed interface
  • ๐Ÿงช Testing & Debugging: AI agents helped identify and fix complex audio timing issues

๐Ÿš€ Development Philosophy

Following the "No Keyboards Allowed" theme, this entire application was conceptualized, designed, and built using AI agents as the primary development tool. The human developer acted as a conductor, directing AI agents to implement complex features while maintaining creative control over the overall vision.

๐ŸŽฎ How to Use

๐ŸŽค Voice Commands

Transport Control:

  • "start" / "play" / "begin" - Start the music
  • "stop" / "pause" / "halt" - Stop the music

Instrument Control:

  • "lead on/off" / "melody on/off" - Toggle lead melody
  • "chords on/off" / "pads on/off" - Toggle chord progression
  • "kick on/off" / "bass drum on/off" - Toggle kick drum
  • "snare on/off" - Toggle snare drum
  • "hats on/off" / "hi-hats on/off" - Toggle hi-hats
  • "bass on/off" / "sub on/off" - Toggle bass line

UI Control:

  • "open/close settings" - Toggle settings panel
  • "open/close about" - Toggle about modal
  • "enter club goose" / "club mode" - Activate club theme
  • "visuals on/off" - Toggle visualizer

๐Ÿ› ๏ธ Technical Architecture

๐ŸŽต Audio Engine

  • Tone.js: Professional audio synthesis and sequencing
  • Real-time Synthesis: Dynamic instrument generation
  • EDM House Patterns: Authentic electronic dance music
  • Multi-layered Audio: Lead, chords, bass, drums, and percussion

๐ŸŽค Voice Recognition

  • Web Speech API: Browser-native speech recognition
  • Command Mapping: Intelligent synonym-based command processing
  • Real-time Processing: Instant voice command execution
  • Error Handling: Robust fallback and retry mechanisms

๐Ÿ•บ Computer Vision

  • Real-time Processing: Low-latency movement tracking
  • Reactive Animations: Visual feedback for all interactions

๐ŸŽจ Visual System

  • Canvas API: High-performance 2D rendering
  • Reactive Visualizer: Beat-synchronized animations
  • Soundwave Display: Real-time audio visualization
  • Theme System: Dynamic visual theming

๐Ÿ”ง State Management

  • Event Bus: Decoupled component communication
  • Global State: Centralized application state
  • Real-time Updates: Live state synchronization
  • Type Safety: Full TypeScript implementation

๐Ÿš€ Getting Started

Prerequisites

  • Modern web browser with Web Speech API support
  • Microphone access
  • Camera access (for future gesture controls)

Installation

  1. Clone the repository:

    git clone https://github.com/your-username/club-goose.git
    cd club-goose
  2. Install dependencies:

    npm install
  3. Start the development server:

    npm run dev
  4. Open your browser: Navigate to http://localhost:3000

  5. Grant permissions:

    • Allow microphone access for voice commands
    • Allow camera access for future gesture recognition
  6. Start conducting:

    • Click "Start Conducting" or say "start"
    • Begin creating music with your voice!

๐ŸŽช Club Mode

Activate Club Mode for the full immersive experience:

  • Enhanced Visuals: Brighter, more dynamic visualizations
  • Club Theme: Nightclub-inspired color schemes
  • Confetti Effects: Celebration animations
  • Welcome Message: Dramatic "WELCOME TO CLUB GOOSE" display

Say "enter club goose" or "club mode" to activate!

๐Ÿงช Development & Testing

Voice Command Testing

Open browser console and use:

// Test voice command recognition
__testVoiceCommand("close settings")
__testVoiceCommand("lead on")

Debug Mode

  • All voice commands are logged to console
  • Real-time state monitoring

๐Ÿ† Hackathon Submission

"No Keyboards Allowed" Compliance

  • โœ… 100% Voice Control: Complete application control via speech
  • โœ… AI Agent Development: Built primarily using Goose AI agents
  • โœ… Hands-free Operation: No keyboard or mouse required
  • โœ… Accessibility: Inclusive design for all users

Innovation Highlights

  • AI-Assisted Development: Demonstrates the future of software development
  • Immersive Music Creation: Revolutionary approach to music production
  • Multi-modal Interaction: Voice + visual feedback
  • Real-time Performance: Low-latency audio and visual processing
  • Professional Quality: Production-ready EDM music generation

๐ŸŽต Music Features

EDM House Music

  • Authentic Patterns: Real house music rhythms and progressions
  • Multi-layered Composition: Lead, chords, bass, drums, and percussion
  • Dynamic Variation: 6 different melody patterns with automatic cycling
  • Professional Sound: High-quality synthesis with effects processing

Audio Effects

  • Chorus & Phaser: Rich, moving lead sounds
  • Compression: Professional audio dynamics
  • Reverb & Delay: Spatial audio effects
  • Filtering: Dynamic frequency shaping

๐ŸŽจ Visual Features

Reactive Visualizer

  • Beat Synchronization: Visuals pulse with the music
  • Soundwave Display: Real-time audio waveform visualization
  • Dynamic Colors: Theme-responsive color schemes
  • Smooth Animations: 60fps visual performance

Goose Mascot

  • Dancing Animation: Reacts to music and user movements
  • Beat Synchronization: Moves in time with the music
  • Playful Character: Adds personality to the experience

๐Ÿ”ง Technical Stack

  • Frontend: Next.js 14, React 18, TypeScript
  • Audio: Tone.js, Web Audio API
  • Vision: MediaPipe, TensorFlow.js
  • Styling: Tailwind CSS, Framer Motion
  • State: Custom event bus, React hooks
  • Deployment: Vercel-ready

๐Ÿค Contributing

This project was built for the "No Keyboards Allowed" hackathon. Contributions are welcome!

  1. Fork the repository
  2. Create a feature branch
  3. Use AI agents to implement changes (following the hackathon theme!)
  4. Submit a pull request

๐Ÿ“„ License

MIT License - feel free to use this project as inspiration for your own "No Keyboards Allowed" creations!

๐ŸŽ‰ Acknowledgments

  • Goose AI Agents: For making this project possible through AI-assisted development
  • "No Keyboards Allowed" Hackathon: For the inspiring challenge
  • Tone.js Community: For the amazing audio synthesis library
  • MediaPipe Team: For the incredible computer vision capabilities

Built with ๐Ÿฆ† Goose AI Agents for the "No Keyboards Allowed" Hackathon

"Conduct your music with nothing but your voice!" ๐ŸŽตโœจ

About

Club Goose delivers hands-free music creation through intuitive voice commands and real-time audio synthesis, and dynamic visual effects to create an immersive conducting experience that responds naturally to your voice.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published