# Stem Splitter & Mixer (Burnt Beats) **Status:** Ready for local testing | Pending deployment Beginner-friendly **stem separator and mixer**: upload a song, split into drums / bass / vocals / other, mix, master, and export. Stem separation runs **CPU-only** (no GPU required). **Product spec:** [docs/stem_guide.md](docs/stem_guide.md) · [docs/detailed_stem_guides.md](docs/detailed_stem_guides.md) --- ## Start here **New to this project?** Read **[START_HERE.md](START_HERE.md)** first. **Architecture:** [ARCHITECTURE.md](ARCHITECTURE.md) --- ## Quick start (WSL) 1. **Server** (from project root): ```bash cd server source venv/bin/activate bash start-local.sh ``` Leave running (Python :5000, Node API :3001). 2. **Frontend** (second terminal, from project root): ```bash npm run dev ``` 3. Open **http://localhost:5173** **First-time setup:** [docs/archive/GET_STARTED.md](docs/archive/GET_STARTED.md) · [docs/archive/WSL_SETUP_GUIDE.md](docs/archive/WSL_SETUP_GUIDE.md) --- ## Scripts | Command | Description | |----------------|--------------------------| | `npm run dev` | Start Vite frontend | | `npm run build`| Build frontend for prod | | `npm run test` / `npm run test:flow` | Playwright E2E | --- ## Repo layout - **Root** — React frontend (Vite): `App.tsx`, `components/`, `store/`, `ual/`, `utils/`, `src/audio/` - **server/** — Node API + Python stem service (Demucs) - **docs/** — Guides and AGENT docs; **docs/archive/** — older status/implementation notes - **e2e/** — Playwright flow tests Older documentation (deployment checklists, implementation summaries, etc.) is in [docs/archive/](docs/archive/). # BEATS-DAW2