# BassMusic.AI

> Free, 100% Client-Side AI Bass Music Generator running in-browser via WebGPU and WebAssembly (WASM SIMD). Zero server inference, zero telemetry, zero audio uploads.

## Overview
BassMusic.AI is a high-performance web application that creates full electronic bass music tracks (Drum & Bass, Dubstep, Trap, Phonk, Midtempo, Halftime, Garage, Breakbeat) and vocal stems directly inside the user's web browser using client-side neural network models.

## Core Capabilities
- **Neural Music Synthesis**: Powered by Meta MusicGen-small (~300M params, INT8 quantized ONNX, ~350MB).
- **Neural AI Vocals**: Powered by lightweight in-browser VITS and MMS models (~35MB ONNX) for MC chants, siren melodies, host speech, and robotic phrases.
- **Vocal Audition & Pre-Approval**: Allows listening to standalone vocal takes with inline playback before full track mixdown.
- **Web Audio Multi-Stem DSP**: Algorithmic sidechain ducking (-12dB to 0dB), 120Hz high-pass filter, 3.5kHz presence boost, algorithmic plate reverb, and stereo panning.
- **Procedural Sound FX Synthesizer**: 8 zero-latency synthesized effects (Sub Drop, Laser Pew, Siren Sweep, Noise Riser, FM Zap, Metallic Impact, 808 Thump, Space Echo).
- **5-Band Parametric EQ & Mastering**: Sub-Bass (60Hz), Bass (250Hz), Mid (1kHz), High-Mid (4kHz), Air (12kHz), plus +4.5dB Sub Boost and tanh soft limiter.
- **Seamless Loop Engine**: 4/8/16-bar tempo-quantized equal-power crossfader for DJ loops.
- **Multi-Format Export**: Studio 16-bit PCM RIFF WAV (up to 48kHz) and MP3 export with progress tracking.
- **Local Storage & Offline Containers**: IndexedDB track history caching, CacheStorage model weight persistence, and `.bassmodel` binary archive backup.
- **Dynamic Theming**: Pro-audio dark slate and clean high-contrast light mode with automatic system detection.

## Quick Links & Resources
- [Full LLM Documentation](https://bassmusic.ai/llms-full.txt): Complete technical specs, prompt syntax, model architectures, and developer API hooks.
- [Web Application](https://bassmusic.ai/): Live in-browser application.
- [Sitemap](https://bassmusic.ai/sitemap.xml): Application sitemap.
- [Source Code & Documentation](https://github.com/PuterVision/bassmusicai): GitHub repository.

## Browser Agent Automation API
When automating BassMusic.AI via browser tools (Playwright, Puppeteer, Chrome DevTools Protocol, Claude Computer Use, Antigravity), interact directly with the window API `window.bassMusicAI`:

```javascript
// Check status
window.bassMusicAI.getStatus();

// Generate a track programmatically
await window.bassMusicAI.generate({
  prompt: "heavy neurofunk drum and bass at 174 BPM, aggressive distorted reese bassline, technical punchy breakbeats",
  bpm: 174,
  duration: 10,
  makeLoopable: true,
  vocals: {
    enabled: true,
    lyrics: "Drop the bass now!",
    voicePreset: "vits_male", // 'vits_male' | 'vits_female' | 'mms_host' | 'vits_cyber'
    timingMode: "pre-drop"    // 'intro' | 'pre-drop' | 'chorus' | 'full'
  }
});

// Audition / preview vocals standalone
await window.bassMusicAI.previewVocals({
  lyrics: "Feel the sub bass roll",
  voicePreset: "vits_female"
});

// Approve vocal preview
window.bassMusicAI.approveVocals();

// Download the active track as WAV
window.bassMusicAI.downloadCurrentWav();
```

## Prompt Engineering Guide
Optimal prompts contain:
1. **Genre & Style**: (e.g. `Neurofunk`, `Tearout Dubstep`, `Phonk Drill`, `Liquid DnB`, `Trap 808`, `UK Garage`)
2. **Explicit BPM tag**: (e.g. `174 BPM`, `140 BPM`, `150 BPM`, `130 BPM`)
3. **Bass Acoustic Details**: (e.g. `screeching wavetable bass`, `deep rolling sub-bass`, `distorted 808 glide`)
4. **Drum & Rhythm Structure**: (e.g. `punchy half-time drums`, `fast rolling breakbeats`, `syncopated hi-hats`)
5. **Atmosphere / Mood**: (e.g. `dark dystopian cyber atmosphere`, `heavy festival moshpit energy`)